OID_RECEIVE_FILTER_CURRENT_CAPABILITIES
過度驅動程式發出 OID_RECEIVE_FILTER_CURRENT_CAPABILITIES 的 OID 查詢要求,以取得網路適配器目前啟用的接收篩選功能。
從 OID 查詢要求成功傳回之後,NDIS_OID_REQUEST 結構 InformationBuffer 成員包含 NDIS_RECEIVE_FILTER_CAPABILITIES 結構的指標。
言論
NDIS 接收篩選器用於下列 NDIS 介面:
NDIS 封包聯合。 如需如何在此介面中使用接收篩選器的詳細資訊,請參閱 管理封包聯合接收篩選。
單一根目錄 I/O 虛擬化 (SR-IOV)。 如需如何在此介面中使用接收篩選的詳細資訊,請參閱在虛擬埠上設定接收篩選器 。
虛擬機佇列 (VMQ)。 如需如何在此介面中使用接收篩選的詳細資訊,請參閱 設定和清除 VMQ 篩選。
從 NDIS 6.20 開始,迷你埠驅動程式會在呼叫 miniportInitializeEx 函式時,註冊目前啟用的網路適配器接收篩選硬體功能。 迷你埠驅動程式會遵循下列步驟來註冊這些功能:
驅動程式會使用目前啟用的接收篩選硬體功能,初始化 NDIS_RECEIVE_FILTER_CAPABILITIES 結構。
驅動程式會初始化 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 結構,並將 CurrentReceiveFilterCapabilities 成員設定為 NDIS_RECEIVE_FILTER_CAPABILITIES 結構的指標。
迷你埠驅動程式會呼叫 NdisMSetMiniportAttributes 函式,並將 MiniportAttributes 參數設定為 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 結構的指標。
過度配置通訊協議和篩選驅動程式不需要發出OID_RECEIVE_FILTER_CURRENT_CAPABILITIES的 OID 查詢要求。 NDIS 會以下列方式提供目前啟用的接收篩選功能給這些驅動程式:
NDIS 提供基礎網路適配器目前啟用的接收篩選功能,讓 ReceiveFilterCapabilities 中的通訊協定驅動程式在系結作業期間NDIS_BIND_PARAMETERS 結構的成員。
NDIS 提供基礎網路適配器目前啟用的接收篩選功能,以在附加作業期間,將 ReceiveFilterCapabilities 中的篩選驅動程式過度NDIS_FILTER_ATTACH_PARAMETERS 結構的成員。
傳回狀態代碼
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。BytesNeededNDIS_OID_REQUEST 結構中的成員,以所需的緩衝區大小下限。
NDIS_STATUS_NOT_SUPPORTED
網路適配器不支援接收篩選。
NDIS_STATUS_FAILURE
要求因其他原因而失敗。
要求
版本 |
NDIS 6.20 和更新版本支援。 |
頁眉 |
Ntddndis.h (包括 Ndis.h) |