共用方式為


OID_RECEIVE_FILTER_CURRENT_CAPABILITIES

過度處理驅動程式發出OID_RECEIVE_FILTER_CURRENT_CAPABILITIES的 OID 查詢要求,以取得網路介面卡目前啟用的接收篩選功能。

從 OID 查詢要求成功傳回之後,NDIS_OID_REQUEST結構的InformationBuffer成員會包含NDIS_RECEIVE_FILTER_CAPABILITIES結構的指標。

備註

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

從 NDIS 6.20 開始,迷你埠驅動程式會在呼叫 其 MiniportInitializeEx 函式時,註冊目前啟用的接收網路介面卡硬體功能。 迷你埠驅動程式會遵循下列步驟來註冊這些功能:

  1. 驅動程式會使用目前啟用的接收篩選硬體功能,初始化 NDIS_RECEIVE_FILTER_CAPABILITIES 結構。

  2. 驅動程式會初始化 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 結構,並將 CurrentReceiveFilterCapabilities 成員設定為 NDIS_RECEIVE_FILTER_CAPABILITIES 結構的指標。

  3. 迷你埠驅動程式會呼叫 NdisMSetMiniportAttributes 函式,並將 MiniportAttributes 參數設定為 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 結構的指標。

過度配置通訊協定和篩選驅動程式不需要發出OID_RECEIVE_FILTER_CURRENT_CAPABILITIES的 OID 查詢要求。 NDIS 會以下列方式為這些驅動程式提供目前啟用的接收篩選功能:

  • NDIS 提供基礎網路介面卡目前啟用的接收篩選功能,以在系結作業期間,將NDIS_BIND_PARAMETERS結構之 ReceiveFilterCapabilities成員中的通訊協定驅動程式過度套用。

  • NDIS 提供基礎網路介面卡目前啟用的接收篩選功能,以在附加作業期間過度篩選NDIS_FILTER_ATTACH_PARAMETERS結構之ReceiveFilterCapabilities成員中的驅動程式。

傳回狀態碼

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

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

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

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

NDIS_STATUS_NOT_SUPPORTED
網路介面卡不支援接收篩選。

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

規格需求

版本

NDIS 6.20 和更新版本支援。

標頭

Ntddndis.h (包含 Ndis.h)

另請參閱

NDIS_BIND_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_OID_REQUEST

NDIS_RECEIVE_FILTER_CAPABILITIES