基になるドライバーとユーザー モード アプリケーションは、ネットワーク アダプターに割り当てられているすべての受信キューの一覧を取得する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 要求 OID_RECEIVE_FILTER_QUEUE_PARAMETERS。
上にあるドライバーとユーザー モード アプリケーションは、ネットワーク アダプターの受信キューを列挙するために、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 は、DATAを設定します。METHOD_INFORMATION.BytesNeeded メンバーを、必要な最小バッファー サイズに NDIS_OID_REQUEST 構造体に格納します。 |
NDIS_STATUS_FAILURE |
その他の理由で要求が失敗しました。 |
必要条件
バージョン |
NDIS 6.20 以降でサポートされています。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |