共用方式為


OID_RECEIVE_FILTER_CLEAR_FILTER

過度處理驅動程式會發出OID_RECEIVE_FILTER_CLEAR_FILTER的 OID 集合要求,以清除網路介面卡上的接收篩選。

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

備註

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

支援 NDIS 封包聯合、SR-IOV 或 VMQ 介面的迷你埠驅動程式,OID_RECEIVE_FILTER_CLEAR_FILTER的 OID 集合要求是必要的。

過度配置驅動程式,例如 NDIS 通訊協定或篩選驅動程式,會使用OID_RECEIVE_FILTER_CLEAR_FILTER集要求來清除先前設定的篩選準則。 只有設定接收篩選準則的驅動程式可以清除它。

過度配置驅動程式會藉由將NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS結構的FilterId成員設定為篩選準則的識別碼,以清除接收篩選。 驅動程式已從先前的 OID 方法要求取得 篩選識別碼,OID_RECEIVE_FILTER_SET_FILTER

NDIS 封包聯合的其他指示

下列幾點適用于支援 NDIS 封包聯合的迷你埠和過度運作驅動程式:

  • 過度配置驅動程式必須先清除它在迷你埠驅動程式上設定的所有接收篩選,才能解除系結或中斷連結驅動程式。

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

下列幾點適用于支援 SR-IOV 介面的迷你埠和過度運作驅動程式:

  • 過度配置驅動程式必須先清除在 SR-IOV VPort 上設定的所有篩選,才能釋放 VPort。 過度配置驅動程式也必須清除預設 VPort 上設定的所有篩選,才能關閉其系結至網路介面卡。

  • 如果迷你埠驅動程式已完成 OID_RECEIVE_FILTER_CLEAR_FILTER 的 OID 要求,則不得指出非預設 VPort 上的封包,以清除 VPort 上的最後一個篩選。

    注意 迷你埠驅動程式也不得指出非預設 VPort 上的封包,如果它已完成 OID_NIC_SWITCH_DELETE_VPORT 的 OID 要求以釋放 VPort。

VMQ 介面的其他指導方針

下列幾點適用于支援 VMQ 介面的迷你埠和過度運用驅動程式:

  • 過度配置驅動程式必須先清除在 VMQ 接收佇列上設定的所有篩選,才能釋放佇列。 過度配置驅動程式也必須清除它在預設或卸載佇列上設定的所有篩選,才能關閉其系結至網路介面卡。

  • 如果迷你埠驅動程式已完成OID_RECEIVE_FILTER_CLEAR_FILTER的 OID 要求,則不得指出接收佇列上的封包,以清除接收佇列的最後一個篩選。

    注意 如果迷你埠驅動程式已完成 OID_RECEIVE_FILTER_FREE_QUEUE 的 OID 要求來釋放接收佇列,則迷你埠驅動程式也不得指出接收佇列上的封包。

傳回狀態碼

miniport 驅動程式的 MiniportOidRequest 函式會針對此要求傳回下列其中一個值:

詞彙 描述

NDIS_STATUS_SUCCESS

迷你埠驅動程式已成功完成要求。

NDIS_STATUS_PENDING

迷你埠驅動程式會以非同步方式完成要求。 迷你埠驅動程式完成所有處理之後,它必須藉由呼叫NdisMOidRequestComplete函式來成功要求,並傳遞Status參數的NDIS_STATUS_SUCCESS

NDIS_STATUS_NOT_ACCEPTED

迷你埠配接器已意外移除。

NDIS 會針對此要求傳回下列其中一個狀態碼:

NDIS_STATUS_SUCCESS
已成功清除指定的篩選。

NDIS_STATUS_PENDING
要求正在擱置完成。 NDIS 會在要求完成之後,將最終狀態代碼和結果傳遞至呼叫端的 OID 要求完成處理常式。

NDIS_STATUS_FILE_NOT_FOUND
篩選識別碼無效。

NDIS_STATUS_INVALID_LENGTH
資訊緩衝區太小。 NDIS 會設定DATA。SET_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員,以達到所需的最小緩衝區大小。

規格需求

版本

NDIS 6.20 和更新版本支援。

標頭

Ntddndis.h (包括 Ndis.h)

另請參閱

NDIS_OID_REQUEST

NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS

OID_NIC_SWITCH_DELETE_VPORT

OID_RECEIVE_FILTER_FREE_QUEUE

OID_RECEIVE_FILTER_SET_FILTER