OID_RECEIVE_FILTER_ENUM_FILTERS

發行項
06/15/2023

過度配置驅動程式發出 OID_RECEIVE_FILTER_ENUM_FILTERS 的 OID 方法要求，以取得網路介面卡上設定的所有篩選清單。

NDIS_OID_REQUEST結構的InformationBuffer成員包含NDIS_RECEIVE_FILTER_INFO_ARRAY結構的指標。

從 OID 方法要求成功傳回之後，NDIS_OID_REQUEST結構的InformationBuffer成員會包含緩衝區的指標。此緩衝區的格式設定為包含下列內容：

NDIS_RECEIVE_FILTER_INFO_ARRAY結構，指定目前在迷你埠驅動程式上設定的接收篩選清單。
NDIS_RECEIVE_FILTER_INFO結構的陣列。每個結構都會指定目前在迷你埠驅動程式上設定之接收篩選的參數。

備註

NDIS 接收篩選準則用於下列 NDIS 介面：

NDIS 封包聯合。如需有關如何在此介面中使用接收篩選的詳細資訊，請參閱管理封包聯合接收篩選。
單一根目錄 I/O 虛擬化 (SR-IOV) 。如需如何在此介面中使用接收篩選的詳細資訊，請參閱在虛擬埠上設定接收篩選。
虛擬機器佇列 (VMQ)。如需有關如何在此介面中使用接收篩選的詳細資訊，請參閱設定和清除 VMQ 篩選。

過度處理驅動程式或應用程式會發出OID_RECEIVE_FILTER_ENUM_FILTERS的 OID 方法要求，以列舉網路介面卡上設定的接收篩選。這包括在 SR-IOV 虛擬埠上設定的接收篩選， (VPort) 或 VMQ 接收佇列。

NDIS 封包聯合介面的其他指導方針

從Windows Server 2012開始，NDIS 封包聯合僅支援網路介面卡的預設接收佇列。

若要列舉封包聯合接收篩選準則，過度配置驅動程式必須將NDIS_RECEIVE_FILTER_INFO_ARRAY結構的QueueId成員設定為NDIS_DEFAULT_RECEIVE_QUEUE_ID。

SR-IOV 介面的其他指導方針

從 Windows Server 2012 開始，SR-IOV 介面僅支援虛擬埠的預設接收佇列 (VPort) 。

若要列舉 VPort 接收篩選準則，過度配置驅動程式必須將NDIS_RECEIVE_FILTER_INFO_ARRAY結構的QueueId成員設定為NDIS_DEFAULT_RECEIVE_QUEUE_ID。

VMQ 介面的其他指導方針

過度配置驅動程式可能會發出 OID_RECEIVE_FILTER_ENUM_FILTERS 的 OID 方法要求，以列舉 VMQ 接收佇列上設定的接收篩選。當過度配置驅動程式初始化 NDIS_RECEIVE_FILTER_INFO_ARRAY 結構時，它會將 QueueId 成員設定為下列其中一個值：

非預設接收佇列的佇列識別碼值。過度處理驅動程式已從先前的 OID 方法要求取得佇列識別碼輸入值， OID_RECEIVE_FILTER_ALLOCATE_QUEUE或 OID_RECEIVE_FILTER_ENUM_QUEUES的 OID 查詢要求。
NDIS_DEFAULT_RECEIVE_QUEUE_ID的佇列識別碼值，指定預設接收佇列。