OID_RECEIVE_FILTER_SET_FILTER

發行項
06/15/2023

過度配置驅動程式發出OID_RECEIVE_FILTER_SET_FILTER的 OID 方法要求，以在網路介面卡上設定篩選。

NDIS_OID_REQUEST結構的InformationBuffer成員包含呼叫端配置的緩衝區指標。此緩衝區的格式設定為包含下列內容：

NDIS_RECEIVE_FILTER_PARAMETERS結構，指定 NDIS 接收篩選的參數。
NDIS_RECEIVE_FILTER_FIELD_PARAMETERS結構的陣列，指定網路封包標頭中欄位的篩選測試準則。

從 OID 方法要求成功傳回之後，NDIS_OID_REQUEST結構的InformationBuffer成員會包含NDIS_RECEIVE_FILTER_PARAMETERS結構的指標。如果過度配置驅動程式正在建立新的接收篩選器，NDIS 會以新的篩選識別碼更新此結構。

備註

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

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

OID_RECEIVE_FILTER_SET_FILTER的 OID 方法要求是支援 NDIS 封包聯合、SR-IOV 或 VMQ 介面的迷你埠驅動程式的必要條件。

過度配置驅動程式會使用其要求的篩選組態，初始化 NDIS_RECEIVE_FILTER_PARAMETERS 結構。 NDIS 會在 NDIS_RECEIVE_FILTER_PARAMETERS 結構的 FilterId 成員中指派篩選識別碼，並將方法要求傳遞至基礎迷你埠驅動程式。

在接收佇列上設定的每個篩選，都有網路介面卡的唯一篩選識別碼。也就是說，篩選識別碼不會在網路介面卡管理的不同佇列上重複。當 NDIS 收到 OID 要求以在接收佇列上設定篩選時，它會驗證篩選參數。在 NDIS 配置必要的資源和篩選識別碼之後，它會將 OID 要求提交至基礎網路介面卡。如果網路介面卡可以成功配置篩選所需的軟體和硬體資源，它會完成 OID 要求，且傳回狀態為 NDIS_STATUS_SUCCESS。

注意從 NDIS 6.30 開始，只有網路介面卡的預設接收佇列才支援封包聯合接收篩選。此接收佇列的識別碼為 NDIS_DEFAULT_RECEIVE_QUEUE_ID。

迷你埠驅動程式必須保留已配置接收篩選準則的篩選識別碼。 NDIS 會在稍後的 OID 要求中使用篩選的識別碼來變更接收篩選參數，或清除接收篩選準則。

在迷你埠驅動程式收到 OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE要求，並在佇列上設定篩選之後，佇列會處於 執行中狀態 。在此狀態下，迷你埠驅動程式可以藉由呼叫 NdisMIndicateReceiveNetBufferLists來啟動佇列中的封包指示。

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

下列幾點適用于支援 SR-IOV 介面的迷你埠驅動程式：

針對 SR-IOV 介面，接收佇列會在預設或非預設虛擬埠上建立， (VPort) 。

注意從Windows Server 2012開始，SR-IOV 介面僅支援 VPort 的預設接收佇列。

透過 OID_NIC_SWITCH_CREATE_VPORT 的 OID 集合要求配置 SR-IOV VPort 之後，過度分配的驅動程式可以在 VPort 上設定篩選，且 OID 要求為 OID_RECEIVE_FILTER_SET_FILTER。

注意只有配置 VPort 的過度配置驅動程式，才能在該 VPort 上設定篩選。
因為預設 VPort 一律存在，所以過度處理驅動程式一律可以在預設 VPort 上設定篩選。
建立 VPort 時，不會設定任何接收篩選。在此情況下，迷你埠驅動程式在迷你埠驅動程式收到 VPort OID_RECEIVE_FILTER_SET_FILTER 的 OID 要求之前，不得指出該 VPort 上的任何接收封包。發出此 OID 要求之後，迷你埠驅動程式可以指出該 VPort 上的封包。

注意如果迷你埠驅動程式在處理OID_RECEIVE_FILTER_SET_FILTER的 OID 要求時指出 VPort 上的封包，則必須完成 OID 要求，並傳回NDIS_STATUS_SUCCESS狀態碼。

VMQ 介面的其他指導方針

下列幾點適用于支援 VMQ 介面的迷你埠驅動程式：

配置 VMQ 接收佇列之後，過度分配的驅動程式可以在接收佇列上設定篩選，並將 OID 要求設為 OID_RECEIVE_FILTER_SET_FILTER。

注意只有配置接收佇列的通訊協定驅動程式可以設定該佇列的篩選。
因為預設佇列一律存在，所以過度處理驅動程式一律可以在預設佇列上設定篩選。如果網路介面卡支援置放佇列，過度配置驅動程式可以在置放佇列上設定篩選。

過度處理驅動程式不會擁有預設或卸載佇列。因此，系結至網路介面卡的所有通訊協定驅動程式都會使用預設或置放佇列。
建立接收佇列時，不會設定任何接收篩選。在此情況下，迷你埠驅動程式不得在迷你埠驅動程式收到接收佇列OID_RECEIVE_FILTER_SET_FILTER的 OID 要求之前，指出該接收佇列上任何接收封包。發出此 OID 要求之後，迷你埠驅動程式可以指出該接收佇列上的封包。

注意如果迷你埠驅動程式在處理OID_RECEIVE_FILTER_SET_FILTER的 OID 要求時指出佇列上的封包，則必須完成 OID 要求，並傳回NDIS_STATUS_SUCCESS狀態碼。