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 を含む) |