Packet32包中的函數說明:
No.3. PacketSetHwFilter (設置過濾器)
設置一個hardware filter。比如，Filter參數傳遞NDIS_PACKET_TYPE_PROMISCUOUS，就可以設置網卡為混雜模式。
BOOLEAN PacketSetHwFilter(
LPADAPTER AdapterObject,
ULONG Filter
);
Parameters：
AdapterObject:
[in] 指向一個_ADAPTER結構的指針。
Filter:
[in] 過濾器的id。
Return Values：
如果執行成功，返回一個非零值。
Usage:
C/C++ Usage Sample
lpAdapter = PacketOpenAdapter(AdapterList[Open-1]);
PacketSetHwFilter(lpAdapter,NDIS_PACKET_TYPE_PROMISCUOUS);
Remarks:
過濾器定義在ntddndis.h中。下面是一些最常用的：
NDIS_PACKET_TYPE_PROMISCUOUS：設置混雜模式。網卡接收每一個Packet；
NDIS_PACKET_TYPE_DIRECTED；
NDIS_PACKET_TYPE_BROADCAST：只接收broadcast packets；
NDIS_PACKET_TYPE_MULTICAST：只接收multicast packets，而且本機網卡是接收組的一個成員；
NDIS_PACKET_TYPE_ALL_MULTICAST：所有multicast packets都接收；
NDIS_PACKET_TYPE_ALL_LOCAL：所有local packets。
這個函數的實現是非常簡單的：
首先填充PACKET_OID_DATA結構的Oid成員為OID_GEN_CURRENT_PACKET_FILTER，填充Data成員為既定的Filter，調用PacketRequest向網卡發送OID請求即可。
No.4. PacketSetBuff (設置緩沖區的大小)
設置捕獲的內核級緩沖區的大小。
BOOLEAN PacketSetBuff(
LPADAPTER AdapterObject,
int dim
);
Parameters：
AdapterObject:
[in] 指向一個_ADAPTER結構的指針。
dim:
[in] 緩沖區的大小(單位：字節)。
Return Values：
如果執行成功，返回一個TRUE。如果沒有足夠的內存分配，返回FALSE。
Usage:
C/C++ Usage Sample
lpAdapter = PacketOpenAdapter(AdapterList[Open-1]);
PacketSetBuff(lpAdapter,512000) ; // 設置driver有512KB字節的緩沖區
Remarks:
一旦設定了一個新緩沖區大小，在原來的那塊緩沖區中的數據就會被丟棄，包括存在裡面的Packets。
注意：內核緩沖區的大小會嚴重影響到捕獲進程的性能。一個適當的緩沖區可以在應用忙時保有數據，從而補償應用的響應延遲，並在網絡活動頻繁時做到不丟失Packets。當driver的一個實例被打開時，這個緩沖區的大小被重設為0：開發者應該記得把它設為一個合適的值，比如設為1MB。
本函數調用了DeviceIoControl，給AdapterObject參數的hFile成員指向的NPF driver設備發送pBIOCSETBUFFERSIZE控制碼。pBIOCSETBUFFERSIZE是在Packet32.h中定義的：
//< IOCTL code: set kernel buffer size：
#define pBIOCSETBUFFERSIZE 9592
No.5. PacketSetReadTimeout (設置讀操作的超時時間)
設置一次讀操作返回的超時時間。
BOOLEAN PacketSetReadTimeout(
LPADAPTER AdapterObject,
int timeout
);
Parameters：
AdapterObject:
[in] 指向一個_ADAPTER結構的指針。
timeout:
[in] 超時時間(單位：毫秒)。
Return Values：
如果執行成功，返回非零值。
Usage:
C/C++ Usage Sample
lpAdapter = PacketOpenAdapter(AdapterList[Open-1]);
PacketSetReadTimeout(lpAdapter,1000) ; // 設置讀操作超時時間1秒
Remarks:
在AdapterObject指向的網卡上調用PacketReceivePacket()，到了設定的超時時間，這次調用就會釋放，即使沒有Packet被捕獲到。
設置超時時間為0，說明沒有超時。這樣，如果沒有Packet到來的話，PacketReceivePacket()方法永不會返回。
設置超時時間為-1，PacketReceivePacket()會立即返回。
這個函數也工作在網卡的統計模式下。所以可以用來設置兩次統計報告之間的時間間隔。
這個函數也是通過DeviceIoControl發送控制碼來實現的。
No.6. PacketAllocatePacket
為_PACKET結構分配內存。
LPPACKET PacketAllocatePacket(void);
Parameters：
無
Return Values：
如果執行成功，返回指向_PACKET結構的指針。否則，返回NULL。
Usage:
C/C++ Usage Sample
LPPACKET lpPacket;
lpPacket = PacketAllocatePacket() ;
Remarks:
這個函數並不負責為_PACKET結構的Buffer成員分配空間。這塊緩沖區必須由應用程序分配，而且必須調用PacketInitPacket來將這緩沖區和_PACKET結構關聯到一起。
No.7. PacketInitPacket
初始化一個_PACKET結構，即將packet結構中的buffer設置為傳遞的buffer指針。
VOID PacketInitPacket(
LPPACKET lpPacket,
PVOID Buffer,
UINT Length
);
Parameters：
lpPacket
[in] 指向一個_PACKET結構的指針。
Buffer
[in] 一個指向一塊用戶分配的緩沖區的指針。捕獲的數據將放置於此。
Length
[in] 緩沖區的大小。這是一個讀操作從driver傳遞到應用的最大數據量。
Return Values：
無。
Usage:
C/C++ Usage Sample
char buffer[256000];
LPPACKET lpPacket;
PacketInitPacket(lpPacket,(char*)buffer,256000);;
Remarks:
Driver能夠用一個讀操作返回幾個Packets，那麼一次調用傳遞給應用程序的packet的數量，就只取決於傳遞給PacketReceivePacket()的_PACKET結構的buffer的大小了。因此用PacketInitPacket()初始化一塊大緩沖區，能夠顯著地減少系統調用，減少捕獲進程在處理器上的影響。
No.8. PacketReceivePacket (讀取數據)
從NPF driver上讀取數據（Packets或者統計信息）。
BOOLEAN PacketReceivePacket(
LPADAPTER AdapterObject,
LPPACKET lpPacket,
BOOLEAN Sync
);
Parameters：
AdapterObject:
[in] 指向一個_ADAPTER結構的指針。
lpPacket:
[in , out] 放數據的_PACKET結構緩沖區。
Sync:
[in] 一個可以忽略的參數，保留它是為了向後兼容。
Return Values：
如果執行成功，返回一個非零值。
Usage:
C/C++ Usage Sample
LPADAPTER lpAdapter = 0;
LPPACKET lpPacket;
lpAdapter = PacketOpenAdapter(AdapterList[Open-1]);
lpPacket = PacketAllocatePacket();
PacketInitPacket(lpPacket,(char*)buffer,256000);
PacketReceivePacket(lpAdapter,lpPacket,TRUE);
Remarks:
這個函數所接收的數據可以是一組Packets，也可以是網絡流量的一個統計數據，依賴於網卡的工作模式。
接收到的Packet的數量是可變的。它依賴於幾個因素：當前存儲在driver緩沖區中的Packet的數目，這些Packet的大小，分配給lpPacket參數的緩沖區的大小。
Packet存儲在lpPacket結構的buffer緩沖區內，lpPacket->Length指示著復制到緩沖區的數據的大小。
它的實現也很簡單：
先看看AdapterObject->ReadTimeOut是否是-1：
如果不是-1，則調用WaitForSingleObject等候AdapterObject->ReadEvent讀事件觸發，超時時間為AdapterObject->ReadTimeOut的數值。如果AdapterObject->ReadTimeOut為0，則永不超時。
如果是-1，就表明讀完立即返回。
之後，調用ReadFile讀取數據。
No.9. PacketGetStats (得到本次捕獲的統計數據)
得到當前捕獲進程的統計信息。
BOOLEAN PacketGetStats(
LPADAPTER AdapterObject,
struct bpf_stat *s
);
Parameters：
AdapterObject:
[in] 指向一個_ADAPTER結構的指針。
s:
[in, out] bpf_stat結構，通過它，我們可以知道接收到的包數，丟失的包數等。
Return Values：
如果執行成功，返回非零值。
Usage:
C/C++ Usage Sample
struct bpf_stat stat;
PacketGetStats(lpAdapter,&stat) ;
Remarks:
通過這個函數，我們可以知道：
從開始捕獲起，這個driver從網卡上接收的Packet的數量(包括driver丟失的Packet)；
從開始捕獲起，這個driver丟失的Packet的數量，一般地，包丟失，是因為driver的緩沖區滿了，這時driver將扔掉這個包。
具體實現也是調用DeviceIoControl函數向設備發送pBIOCGSTATS控制碼，得到一個bpf_stat結構，然後只把這個結構的bs_recv和bs_drop成員返回。
No.10. PacketCloseAdapter
關閉網卡。
VOID PacketCloseAdapter(LPADAPTER lpAdapter);
Parameters：
lpAdapter:
[in] 指向一個_ADAPTER結構的指針。
Remarks:
依次做下面的動作：
關閉lpAdapter->hFile，打開的NPF driver的實例句柄；
觸發lpAdapter->ReadEvent，並關閉這個句柄；
解鎖並釋放lpAdapter。
(To be continued)
Writen by [email protected]
本文檔所包含的信息代表了在發布之日，ZhengYun 對所討論問題的當前看法，Zhengyun 不保證所給信息在發布之日以後的准確性。
本文檔僅供參考。對本文檔中的信息，Zhengyun 不做任何明示或默示的保證。
