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_RECEIVE_FILTER_PARAMETERS 構造体。
ネットワーク パケット ヘッダー内のフィールド用にフィルター テスト条件を指定する NDIS_RECEIVE_FILTER_FIELD_PARAMETERS 構造体の配列。
解説
NDIS 受信フィルターは、次の NDIS インターフェイスで使用されます：
NDIS Packet Coalescing. このインターフェイスで受信フィルターを使用する方法の詳細については、 パケット結合受信フィルター の管理 を参照してください。
シングル ルート I/O 仮想化 (SR-IOV)。 このインターフェイスで受信フィルターを使用する方法の詳細については、 仮想ポートでの受信フィルターの設定 を参照してください。
仮想マシン キュー (VMQ). このインターフェイスで受信フィルターを使用する方法の詳細については、 VMQフィルターの設定とクリアを参照してください。
上位ドライバーは、ネットワークアダプターで設定された受信フィルターの構成パラメーターを取得する 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 を含む) |
関連項目
OID_RECEIVE_FILTER_ENUM_FILTERS