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 |
要求は正常に完了しました。 InformationBuffer は NDIS_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 を含む) |