共用方式為


OID_RECEIVE_FILTER_PARAMETERS

過度處理驅動程式會發出 OID_RECEIVE_FILTER_PARAMETERS 的 OID 方法要求,以取得網路介面卡上篩選的目前組態參數。

NDIS_OID_REQUEST結構的InformationBuffer成員包含NDIS_RECEIVE_FILTER_PARAMETERS結構的指標。 NDIS 會使用輸入結構中的 FilterId 成員來識別篩選。

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

備註

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

過度處理驅動程式會發出OID_RECEIVE_FILTER_PARAMETERS的 OID 方法要求,以取得網路介面卡上設定之接收篩選器的組態參數。 這包括在 VMQ 接收佇列或 SR-IOV 虛擬埠上設定的接收篩選器, (VPort) ,以及下載至迷你埠驅動程式的封包聯合篩選器。

過度處理驅動程式從先前的 OID 方法要求 取得OID_RECEIVE_FILTER_SET_FILTER 的篩選識別碼,或從 OID_RECEIVE_FILTER_ENUM_FILTERS的 OID 要求取得。

傳回狀態碼

NDIS 會處理迷你埠驅動程式OID_RECEIVE_FILTER_PARAMETERS的 OID 要求,並傳回下列其中一個狀態碼:

NDIS_STATUS_SUCCESS
要求已順利完成。 InformationBuffer會指向NDIS_RECEIVE_FILTER_PARAMETERS結構。

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

NDIS_STATUS_INVALID_PARAMETER
過度處理驅動程式或應用程式提供了不正確篩選識別碼。 如果篩選識別碼為零,或指定未定義的篩選,則篩選識別碼無效。

NDIS_STATUS_INVALID_LENGTH
資訊緩衝區太短。 NDIS 會設定DATA。QUERY_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員,到所需的緩衝區大小下限。

NDIS_STATUS_FAILURE
要求因其他原因而失敗。

規格需求

版本

NDIS 6.20 和更新版本支援。

標頭

Ntddndis.h (包含 Ndis.h)

另請參閱

NDIS_OID_REQUEST

OID_RECEIVE_FILTER_ENUM_FILTERS

NDIS_RECEIVE_FILTER_PARAMETERS

OID_RECEIVE_FILTER_SET_FILTER