OID_RECEIVE_FILTER_QUEUE_PARAMETERS

  • [アーティクル]

上位ドライバーは、受信キューの現在の構成パラメーターを取得するOID_RECEIVE_FILTER_QUEUE_PARAMETERSのオブジェクト識別子 (OID) メソッド要求を発行します。 この NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、タイプ NDIS_RECEIVE_QUEUE_ID のキュー識別子を持つ NDIS_RECEIVE_QUEUE_PARAMETERS 構造体へのポインターが含まれています 。 OID メソッド要求から正常に戻った後、 NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、 NDIS_RECEIVE_QUEUE_PARAMETERS 構造体へのポインターが含まれています。

上位ドライバーは、キューの現在の構成パラメーターを変更する OID_RECEIVE_FILTER_QUEUE_PARAMETERS の OID セット要求を発行します。 上位ドライバーは、 NDIS_OID_REQUEST 構造体の InformationBuffer メンバーの NDIS_RECEIVE_QUEUE_PARAMETERS へのポインターを提供します。

解説

上位ドライバーは、1つ以上の受信キューのパラメーターを変更する OID_RECEIVE_FILTER_QUEUE_PARAMETERS の OID セット要求を発行します。 OID セット要求は、NDIS 6.20 以降のミニポート ドライバーではオプションとなります。 ただし、OID 要求は、仮想マシン キュー (VMQ) インターフェイスをサポートするミニポート ドライバーに必須です。

注 キューを割り当てた上位ドライバーのみが、OID_RECEIVE_FILTER_QUEUE_PARAMETERSの OID セット要求を発行することによって構成パラメーターを変更できます。

上位ドライバーは、以前の OID_RECEIVE_FILTER_ALLOCATE_QUEUE メソッド OID 要求からキュー識別子の入力値を取得しました。

上位ドライバーは、キューを割り当てた後、 NDIS_RECEIVE_QUEUE_PARAMETERS 構造体の Flags メンバーの変更フラグ (NDIS_RECEIVE_QUEUE_PARAMETER_Xxx_CHANGED) を変更できます。 ただし、キューが割り当てられた後、上位ドライバーは、対応する変更フラグを持たない構成パラメーターを変更できません。

状態コードを返します

NDIS は、ミニポート ドライバーのOID_RECEIVE_FILTER_PARAMETERSの OID メソッド要求を処理し、次のいずれかの状態コードを返します。

状態コード 説明

NDIS_STATUS_SUCCESS

要求は正常に完了しました。

NDIS_STATUS_PENDING

要求の完了が保留中です。 NDIS は、要求が完了した後、呼び出し元の OID 要求完了ハンドラーに最終的な状態コードと結果を渡すことになります。

NDIS_STATUS_INVALID_LENGTH

情報バッファーが短すぎました。 NDISは、NDIS_OID_REQUEST 構造体の DATA.METHOD_INFORMATION.BytesNeeded メンバー を 必要な最小バッファサイズに設定します。

NDIS_STATUS_INVALID_PARAMETER

この要求は、下位ネットワークアダプターがサポートしていない機能を有効にしようとしたため、失敗しました。

NDIS_STATUS_FAILURE

その他の理由で要求に失敗しました。

要件

バージョン

NDIS 6.20 以降でサポートされています。

ヘッダー

 Ntddndis.h (Ndis.h を含む)

関連項目

NDIS_OID_REQUEST

NDIS_RECEIVE_QUEUE_PARAMETERS

OID_RECEIVE_FILTER_ALLOCATE_QUEUE

OID_RECEIVE_FILTER_QUEUE_PARAMETERS