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_QUEUE_PARAMETERSの OID メソッド要求を処理し、次のいずれかの状態コードを返します。
| 状態コード | 形容 |
|---|---|
NDIS_STATUS_SUCCESS |
要求が正常に完了しました。 |
NDIS_STATUS_PENDING |
要求の完了が保留中です。 NDIS は、要求が完了した後、呼び出し元の OID 要求完了ハンドラーに最終的な状態コードと結果を渡します。 |
NDIS_STATUS_INVALID_LENGTH |
情報バッファーが短すぎます。 NDIS は、DATAを設定します。METHOD_INFORMATION.BytesNeeded メンバーを、必要な最小バッファー サイズにNDIS_OID_REQUEST構造体に格納します。 |
NDIS_STATUS_INVALID_PARAMETER |
基になるネットワーク アダプターがサポートしていない機能を有効にしようとしたため、要求が失敗しました。 |
NDIS_STATUS_FAILURE |
その他の理由で要求が失敗しました。 |
必要条件
バージョン |
NDIS 6.20 以降でサポートされています。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |