次の方法で共有


OID_RECEIVE_FILTER_ENUM_QUEUES

上部のドライバーとユーザー モード アプリケーションは、OID_RECEIVE_FILTER_ENUM_QUEUES のオブジェクト識別子 (OID) クエリ要求を発行して、ネットワーク アダプターに割り当てられているすべての受信キューの一覧を取得します。

OID クエリ要求から正常に返されると、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーは、各フィルターの NDIS_RECEIVE_QUEUE_INFO 構造体が続く NDIS_RECEIVE_QUEUE_INFO_ARRAY 構造体へのポインターが含まれます。

解説

NDIS は、OID_RECEIVE_FILTER_ALLOCATE_QUEUE および OID_RECEIVE_FILTER_QUEUE_PARAMETERS OID 要求から受信したデータの内部キャッシュから情報を取得しています。

上部のドライバーとユーザー モード アプリケーションは、OID_RECEIVE_FILTER_ENUM_QUEUES の OID クエリ要求を発行して、ネットワーク アダプターの受信キューを列挙します。

プロトコル ドライバーが要求を発行した場合は、NDIS_OID_REQUEST 構造体内 の要求の種類が NdisRequestQueryInformation に設定され、この OID は、プロトコル ドライバーがネットワーク アダプターで割り当てたすべての受信キューの配列を返します。 ユーザー モード アプリケーションが要求を発行した場合は、NDIS_OID_REQUEST 構造体内の要求の種類は NdisRequestQueryStatistics に設定され、この OID は、ネットワーク アダプター上のすべての受信キューの情報の配列を返します。

状態コードを返す

NDIS は、ミニポート ドライバーに対する OID_RECEIVE_FILTER_ENUM_QUEUES の OID クエリ要求を処理し、次のいずれかの状態コードを返します。

状態コード 説明

NDIS_STATUS_SUCCESS

要求は正常に完了しました。 InformationBufferNDIS_RECEIVE_QUEUE_INFO_ARRAY 構造体を指します。

NDIS_STATUS_PENDING

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

NDIS_STATUS_INVALID_LENGTH

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

NDIS_STATUS_FAILURE

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

要件

バージョン

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

ヘッダー

Ntddndis.h (Ndis.h を含む)

関連項目

NDIS_OID_REQUEST

NDIS_RECEIVE_QUEUE_INFO

NDIS_RECEIVE_QUEUE_INFO_ARRAY

OID_RECEIVE_FILTER_ALLOCATE_QUEUE

OID_RECEIVE_FILTER_QUEUE_PARAMETERS