次の方法で共有


OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE

NDIS プロトコル ドライバーは、受信キューの現在のバッチ割り当てが完了したことをミニポート ドライバーに通知する OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE のオブジェクト識別子 (OID) メソッド要求を発行します。

この NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、 NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_ARRAY 構造体へのポインターが含まれており、これに各キュー用の NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_PARAMETERS 構造体が続きます。 OID メソッド要求から正常に戻った後、 NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、同じ構造体配列へのポインターが含まれており、各 NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_PARAMETERS 構造体の CompletionStatus メンバーには、各キューの完了状態が含まれています。

解説

OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE の OID メソッド要求は、NDIS 6.20 およびこれ以降のミニポート ドライバーではオプションになります。 これは、仮想マシン・キュー (VMQ) インターフェースをサポートするミニポート・ドライバーには必須のものです。

1つ以上の受信キューを割り当てて、オプションで初期フィルターを設定した後、プロトコル ドライバーは、受信キューの現在のバッチに対する割り当てが完了したことをミニポート ドライバーに通知するために、OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE の OID メソッド要求を発行する必要があります。 これによって、ミニポート ドライバーは、複数の受信キュー間でハードウェア リソースのバランスをとることができるようになります。必要な場合は、受信キューに共有メモリなどのリソースを割り当てることができます。

ミニポート ドライバーが OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE 要求を受信して、キューに設定されているフィルターがある場合、キューは実行状態になります。 この状態で、ミニポート ドライバーは NdisMIndicateReceiveNetBufferLists を呼び出すことによって、キュー内のパケットの表示を開始できます。

状態コードを返します

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

状態コード 説明

NDIS_STATUS_SUCCESS

キューの割り当てが完了しました。 情報バッファーには、更新 されたNDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_ARRAY 構造体とパラメーター構造と、キュー割り当ての完了状態が含まれます。

NDIS_STATUS_PENDING

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

NDIS_STATUS_INVALID_PARAMETER

上位ドライバーが指定した1つ以上のパラメーターが無効でした。

NDIS_STATUS_INVALID_LENGTH

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

NDIS_STATUS_NOT_SUPPORTED

ミニポート ドライバーの NDIS バージョンは、バージョン 6.20 以前のものです。

NDIS_STATUS_FAILURE

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

要件

バージョン

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

ヘッダー

Ntddndis.h (Ndis.h を含む)

関連項目

NdisMIndicateReceiveNetBufferLists

NDIS_OID_REQUEST

NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_ARRAY

NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_PARAMETERS