OID_RECEIVE_FILTER_PARAMETERS
基になるドライバーは、ネットワーク アダプターのフィルターの現在の構成パラメーターを取得するOID_RECEIVE_FILTER_PARAMETERSの OID メソッド要求を発行します。
NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_RECEIVE_FILTER_PARAMETERS 構造体へのポインターが含まれています。 NDIS は、フィルターを識別する入力構造体の FilterId メンバーを使用します。
OID メソッド要求から正常に戻った後、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーにはバッファーへのポインターが含まれます。 このバッファーは、次のように書式設定されます。
NDIS 受信フィルターのパラメーターを指定する NDIS_RECEIVE_FILTER_PARAMETERS 構造体。
ネットワーク パケット ヘッダー内のフィールドのフィルター テスト条件を指定する NDIS_RECEIVE_FILTER_FIELD_PARAMETERS 構造体の配列。
備考
NDIS 受信フィルターは、次の NDIS インターフェイスで使用されます。
NDIS パケット結合。 このインターフェイスで受信フィルターを使用する方法の詳細については、「パケット結合受信フィルターの管理を参照してください。
シングル ルート I/O 仮想化 (SR-IOV)。 このインターフェイスで受信フィルターを使用する方法の詳細については、「仮想ポート で受信フィルターを設定するを参照してください。
仮想マシン キュー (VMQ) をします。 このインターフェイスで受信フィルターを使用する方法の詳細については、「VMQ フィルターの設定とクリア」を参照してください。
基になるドライバーは、ネットワーク アダプターで設定された受信フィルターの構成パラメーターを取得するOID_RECEIVE_FILTER_PARAMETERSの OID メソッド要求を発行します。 これには、VMQ 受信キューまたは仮想ポート (VPort) SR-IOV 設定された受信フィルターと、ミニポート ドライバーにダウンロードされたパケット結合フィルターが含まれます。
上にあるドライバーは、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 は、データを設定します。QUERY_INFORMATION。BytesNeededNDIS_OID_REQUEST 構造体のメンバーを、必要な最小バッファー サイズに設定します。
NDIS_STATUS_FAILURE
その他の理由で要求が失敗しました。
必要条件
バージョン |
NDIS 6.20 以降でサポートされています。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |
関連項目
OID_RECEIVE_FILTER_ENUM_FILTERS