OID_RECEIVE_FILTER_PARAMETERS
過度配置驅動程式會發出 OID_RECEIVE_FILTER_PARAMETERS 的 OID 方法要求,以取得網路適配器上篩選條件的目前組態參數。
InformationBufferNDIS_OID_REQUEST 結構的成員包含 NDIS_RECEIVE_FILTER_PARAMETERS 結構的指標。 NDIS 會使用輸入結構中的 FilterId 成員來識別篩選。
從 OID 方法要求成功傳回之後,InformationBufferNDIS_OID_REQUEST 結構的成員包含緩衝區的指標。 此緩衝區的格式設定為包含下列專案:
NDIS_RECEIVE_FILTER_PARAMETERS 結構,指定 NDIS 接收篩選的參數。
NDIS_RECEIVE_FILTER_FIELD_PARAMETERS 結構的陣列,指定網路封包標頭中欄位的篩選測試準則。
言論
NDIS 接收篩選器用於下列 NDIS 介面:
NDIS 封包聯合。 如需如何在此介面中使用接收篩選器的詳細資訊,請參閱 管理封包聯合接收篩選。
單一根目錄 I/O 虛擬化 (SR-IOV)。 如需如何在此介面中使用接收篩選的詳細資訊,請參閱在虛擬埠上設定接收篩選器 。
虛擬機佇列 (VMQ)。 如需如何在此介面中使用接收篩選的詳細資訊,請參閱 設定和清除 VMQ 篩選。
過度配置驅動程式發出 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。BytesNeededNDIS_OID_REQUEST 結構中的成員,以所需的緩衝區大小下限。
NDIS_STATUS_FAILURE
要求因其他原因而失敗。
要求
版本 |
NDIS 6.20 和更新版本支援。 |
頁眉 |
Ntddndis.h (包括 Ndis.h) |
另請參閱
OID_RECEIVE_FILTER_ENUM_FILTERS