win5

st1/:*{behavior:url(#ieooui) } 1.4.2 PacketGetAdapterNames函数函数PacketGetAdapterNames获取可用网络适配器的一个列表与它们的描述。参数pStr是用户分配的字符串，用来存储适配器的名称。参数BufferSize是pStr所指缓冲区的长度。如果函数失败，该变量返回存储适配器列表所需的字节数。如果函数成功，返回非0值。如果返回值为0，BufferSize返回存储适配器列表所需的字节数。通常，这是第一个与驱动程序通信的函数。它返回系统上所安装的WinPcap能支持的适配器名称。在适配器的名称之后，pStr包含一个字符串用对每一个适配器进行描述。在调用PacketGetAdapterNames函数后，pStr字符串的格式如下所示：Ø 一些数量的ASCII字符串，每个适配器的名称之间由一个"/0"分开Ø 两个"/0"Ø 许多ASCII字符串，之间由一个"/0"分隔，每一个描述一个对应适配器。描述的数量与名称的数量一样。第一个描述对应于第一个名称，以此类推。 Ø 两个"/0" packetNtx/Dll/Packet32.c：3616-3723BOOLEAN PacketGetAdapterNames(PTSTR pStr,PULONG BufferSize){ …/*创建适配器链表*/ PacketPopulateAdaptersInfoList(); /*获得g_AdaptersInfoMutex互斥信号*/ WaitForSingleObject(g_AdaptersInfoMutex, INFINITE); if(!g_AdaptersInfoList) { //失败系统中没有找到适配器，函数返回 … } /**填充pStr中适配器的名称与描述两个列表*/ //第一次遍历g_AdaptersInfoList，//为了计算第二个列表开始的偏移与检查缓冲区的大小 for (TAdInfo = g_AdaptersInfoList; TAdInfo != NULL; TAdInfo = TAdInfo->Next) { if(TAdInfo->Flags != INFO_FLAG_DONT_EXPORT) { // 更新有关大小的变量值 SizeNeeded += (ULONG)strlen(TAdInfo->Name) + (ULONG)strlen(TAdInfo->Description) + 2; SizeNames += (ULONG)strlen(TAdInfo->Name) + 1; } } //检查缓冲区大小，以防缓冲区溢出。//注意:需要2个额外的分隔符（两个列表间一个’/0’,//第二个列表结束时的一个’/0’） if(SizeNeeded + 2 > *BufferSize || pStr == NULL) { ReleaseMutex(g_AdaptersInfoMutex); *BufferSize = SizeNeeded + 2; //报告所需的缓冲区大小 SetLastError(ERROR_INSUFFICIENT_BUFFER); return FALSE; } OffDescriptions = SizeNames + 1;//第二个列表开始的偏移 //第二次遍历g_AdaptersInfoList，为了复制适配器的信息 for(TAdInfo = g_AdaptersInfoList, SizeNames = 0, SizeDesc = 0; TAdInfo != NULL; TAdInfo = TAdInfo->Next) { if(TAdInfo->Flags != INFO_FLAG_DONT_EXPORT) { // 复制数据 StringCchCopyA( ((PCHAR)pStr) + SizeNames, *BufferSize - SizeNames, TAdInfo->Name); StringCchCopyA( ((PCHAR)pStr) + OffDescriptions + SizeDesc, *BufferSize - OffDescriptions - SizeDesc, TAdInfo->Description); // 更新有关大小的变量值 SizeNames += (ULONG)strlen(TAdInfo->Name) + 1; SizeDesc += (ULONG)strlen(TAdInfo->Description) + 1; } } //分隔两个列表 ((PCHAR)pStr)[SizeNames] = 0; // 添加一个/0，结束列表 ((PCHAR)pStr)[SizeNeeded + 1] = 0; //释放g_AdaptersInfoMutex互斥信号 ReleaseMutex(g_AdaptersInfoMutex); return TRUE;}函数首先调用PacketPopulateAdaptersInfoList()函数创建适配器链表g_AdaptersInfoList。接着开始给pStr中填充适配器的名称与描述两个列表，在填充的过程中，需要遍历g_AdaptersInfoList两次，第一次遍历是为了计算第二个列表开始的偏移与检查缓冲区的大小，第二次遍历是为了复制适配器的名称与描述信息。复制数据结束后，在两个列表之间加入分隔符’/0’，并在第二个列表之后添加一个’/0’结束列表。