NdisFIndicateReceiveNetBufferLists 函式 (ndis.h)

篩選驅動程式會呼叫 NdisFIndicateReceiveNetBufferLists 來指出它已收到網路數據。 如需詳細資訊，請參閱 在篩選驅動程式中接收數據。

語法

void NdisFIndicateReceiveNetBufferLists(
  [in] NDIS_HANDLE      NdisFilterHandle,
  [in] PNET_BUFFER_LIST NetBufferLists,
  [in] NDIS_PORT_NUMBER PortNumber,
  [in] ULONG            NumberOfNetBufferLists,
  [in] ULONG            ReceiveFlags
);

參數

[in] NdisFilterHandle

識別此篩選模組的 NDIS 句柄。 NDIS 在對 FilterAttach 函式的呼叫中，將句柄傳遞至篩選驅動程式。

[in] NetBufferLists

NET_BUFFER_LIST結構的連結清單。 每個 NET_BUFFER_LIST 結構都包含一個 NET_BUFFER 結構。

[in] PortNumber

識別迷你埠配接器埠的埠號碼。 迷你埠配接器埠號碼是藉由呼叫 NdisMAllocatePort 函式來指派。 零值會識別迷你埠配接器的預設埠。

[in] NumberOfNetBufferLists

NetBufferLists 中結構連結清單中的NET_BUFFER_LIST結構數目。

[in] ReceiveFlags

旗標，定義接收指示的屬性。 旗標可以與 OR 作業結合。 若要清除所有旗標，請將此成員設定為零。 此函式支援下列旗標：

NDIS_RECEIVE_FLAGS_DISPATCH_LEVEL

指定目前的 IRQL DISPATCH_LEVEL。 如需此旗標的詳細資訊，請參閱 分派 IRQL 追蹤。

NDIS_RECEIVE_FLAGS_RESOURCES

指定篩選驅動程式會在呼叫 NdisFIndicateReceiveNetBufferLists 之後，立即回收NET_BUFFER_LIST結構的擁有權和任何附加NET_BUFFER結構。

NDIS_RECEIVE_FLAGS_SINGLE_ETHER_TYPE

指定 NetBufferLists 清單中的所有NET_BUFFER_LIST結構都有相同的通訊協定類型 (EtherType) 。

NDIS_RECEIVE_FLAGS_SINGLE_VLAN

指定 NetBufferLists 清單中的所有NET_BUFFER_LIST結構都屬於相同的 VLAN。

NDIS_RECEIVE_FLAGS_PERFECT_FILTERED

指定 NetBufferLists 清單中的所有NET_BUFFER_LIST結構只包含符合指派給迷你埠配接器之封包篩選和多播通訊清單的數據。

NDIS_RECEIVE_FLAGS_SINGLE_QUEUE

指定 NetBufferLists 清單中的所有NET_BUFFER_LIST結構都屬於相同的 VM 佇列。 迷你埠驅動程序必須在 的 Flags 成員中設定NDIS_RECEIVE_QUEUE_PARAMETERS_PER_QUEUE_RECEIVE_INDICATION旗標時，針對佇列上的所有接收指示設定此旗標 NDIS_RECEIVE_QUEUE_PARAMETERS 配置該佇列時的結構。

NDIS_RECEIVE_FLAGS_SHARED_MEMORY_INFO_VALID

指定 NetBufferLists 清單中的所有NET_BUFFER_LIST結構都包含有效的共用記憶體資訊。 當收到 NET_BUFFER_LIST上設定此旗標時，NDIS 會將共用記憶體資訊視為有效。 未設定此旗標時，NDIS 和驅動程式會忽略共用記憶體資訊。 例如，修改封包數據的中繼驅動程式可以使用這個旗標來判斷是否應該複製數據。 迷你埠驅動程式可以使用 旗標來決定如何在刪除佇列時釋放與 VM 佇列相關聯的記憶體。

NDIS_RECEIVE_FLAGS_MORE_NBLS

保留的。

NDIS_RECEIVE_FLAGS_SWITCH_SINGLE_SOURCE

如果已設定此旗標，則 NET_BUFFER_LIST結構連結 清單中的所有封包都源自相同的 Hyper-V 可延伸交換器來源埠。

如需詳細資訊，請參閱 Hyper-V 可延伸交換器傳送和接收旗標。

NDIS_RECEIVE_FLAGS_SWITCH_DESTINATION_GROUP

如果設定此旗標， 則NET_BUFFER_LIST 結構連結清單中的所有封包都會轉送至相同的可延伸交換器目的地埠。

如需詳細資訊，請參閱 Hyper-V 可延伸交換器傳送和接收旗標。

傳回值

無

備註

當篩選驅動程式呼叫 NdisFIndicateReceiveNetBufferLists 函式時，它會指定 NetBufferLists 參數中NET_BUFFER_LIST結構的清單。 NDIS 會將 NET_BUFFER_LIST 結構傳遞至超載驅動程式。

篩選驅動程式可以呼叫 NdisFIndicateReceiveNetBufferLists 來產生接收指示。

篩選驅動程式也可以篩選基礎驅動程式產生的指示。 NDIS 會呼叫 FilterReceiveNetBufferLists 函式可篩選這類接收指示。

篩選驅動程式必須設定其來源與 NdisFilterHandle 參數相同的值的每個NET_BUFFER_LIST結構 SourceHandle 成員。 篩選驅動程式不得修改任何來源NET_BUFFER_LIST結構中的SourceHandle成員。

篩選驅動程式必須正確初始化 NET_BUFFER_LIST 結構、附加 NET_BUFFER 結構，以及任何附加的 MDL。

如果篩選驅動程式呼叫 NdisFIndicateReceiveNetBufferLists 函式，並清除 ReceiveFlags 參數中的NDIS_RECEIVE_FLAG_RESOURCES旗標，NDIS 會將指定的NET_BUFFER_LIST結構傳回至篩選驅動程式的 FilterReturnNetBufferLists 函式 。 在此情況下，在 NDIS 將NET_BUFFER_LIST結構傳回 FilterReturnNetBufferLists 之前，篩選驅動程式不得回收NET_BUFFER_LIST結構。

如果篩選驅動程式呼叫 NdisFIndicateReceiveNetBufferLists 並在 ReceiveFlags 參數中設定NDIS_RECEIVE_FLAG_RESOURCES旗標，這表示篩選驅動程式必須立即重新取得NET_BUFFER_LIST結構的擁有權。 在此情況下，NDIS 不會呼叫篩選驅動程式的 FilterReturnNetBufferLists 函式，以傳回 NET_BUFFER_LIST 結構。 相反地，NDIS 會在從 NdisFIndicateReceiveNetBufferLists 傳回時，將NET_BUFFER_LIST結構傳回至篩選驅動程式。 篩選驅動程序應該會在 NdisFIndicateReceiveNetBufferLists 傳回之後立即回收NET_BUFFER_LIST結構。 若要回收 NET_BUFFER_LIST 結構，篩選驅動程式可以呼叫自己的 FilterReturnNetBufferLists 函式。

在 ReceiveFlags 參數中設定NDIS_RECEIVE_FLAG_RESOURCES旗標會強制過度配置驅動程式複製網路數據，並將NET_BUFFER_LIST結構釋放至篩選驅動程式。

規格需求

另請參閱

FilterAttach

FilterReceiveNetBufferLists

FilterReturnNetBufferLists

NDIS_RECEIVE_QUEUE_PARAMETERS

NET_BUFFER

NET_BUFFER_LIST

NdisMAllocatePort

在篩選驅動程式中接收數據