次の方法で共有

OID_RECEIVE_FILTER_PARAMETERS

  • [アーティクル]

上位ドライバーは、ネットワークアダプター上にあるフィルターの現在の構成パラメーターを取得する OID_RECEIVE_FILTER_PARAMETERS の OID メソッド要求を発行します。

この NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、 NDIS_RECEIVE_FILTER_PARAMETERS 構造体へのポインターが含まれています。 NDIS は、入力構造体の FilterId メンバーを使用して、フィルターを識別します。

OID メソッド要求から正常に戻った後、 NDIS_OID_REQUEST 構造体の InformationBuffer メンバーは、1つのバッファーへのポインターを含んでいます。 このバッファーは、次のようにフォーマットされます：

解説

NDIS 受信フィルターは、次の NDIS インターフェイスで使用されます：

上位ドライバーは、ネットワークアダプターで設定された受信フィルターの構成パラメーターを取得する OID_RECEIVE_FILTER_PARAMETERSの OID メソッド要求を発行します。 これには、VMQ 受信キューまたは SR-IOV 仮想ポート (VPort) に設定された受信フィルターと、ミニポート ドライバーにダウンロードされたパケット結合フィルターが含まれます。

上位ドライバーは、フィルター識別子を OID_RECEIVE_FILTER_SET_FILTER の以前の OID メソッド要求から、または 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
上位ドライバーまたはアプリケーションが無効なフィルター識別子を提供しました。 フィルター識別子が 0 の場合、または未定義のフィルターを指定している場合、フィルター識別子は無効です。

NDIS_STATUS_INVALID_LENGTH
情報バッファーが短すぎました。 NDIS は、 NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.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