NDIS_RECEIVE_QUEUE_INFO構造体 (ntddndis.h)
NDIS_RECEIVE_QUEUE_INFO 構造体には、ネットワーク アダプターの受信キューに関する情報が含まれています。
構文
typedef struct _NDIS_RECEIVE_QUEUE_INFO {
NDIS_OBJECT_HEADER Header;
ULONG Flags;
NDIS_RECEIVE_QUEUE_TYPE QueueType;
NDIS_RECEIVE_QUEUE_ID QueueId;
NDIS_RECEIVE_QUEUE_GROUP_ID QueueGroupId;
NDIS_RECEIVE_QUEUE_OPERATIONAL_STATE QueueState;
GROUP_AFFINITY ProcessorAffinity;
ULONG NumSuggestedReceiveBuffers;
ULONG MSIXTableEntry;
ULONG LookaheadSize;
NDIS_VM_NAME VmName;
NDIS_QUEUE_NAME QueueName;
ULONG NumFilters;
ULONG InterruptCoalescingDomainId;
} NDIS_RECEIVE_QUEUE_INFO, *PNDIS_RECEIVE_QUEUE_INFO;
メンバーズ
Header
NDIS_RECEIVE_QUEUE_INFO 構造体の型、リビジョン、およびサイズ。 このメンバーは、NDIS_OBJECT_HEADER 構造体として書式設定されます。
ミニポート ドライバーは、ヘッダー の 型 メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。 NDIS_RECEIVE_QUEUE_INFO 構造体のバージョンを指定するには、ドライバーは、ヘッダー の リビジョン メンバーを次のいずれかの値に設定する必要があります。
NDIS_RECEIVE_QUEUE_INFO_REVISION_2
NDIS 6.30 の追加メンバーを追加しました。
Size メンバーを NDIS_SIZEOF_RECEIVE_QUEUE_INFO_REVISION_2に設定します。
NDIS_RECEIVE_QUEUE_INFO_REVISION_1
NDIS 6.20 の元のバージョン。
Size メンバーを NDIS_SIZEOF_RECEIVE_QUEUE_INFO_REVISION_1に設定します。
Flags
フラグのビットごとの または を含む ULONG 値。 このメンバーは NDIS 用に予約されています。
QueueType
受信キューの種類を指定する NDIS_RECEIVE_QUEUE_TYPE 列挙値。
QueueId
受信キュー識別子を含む NDIS_RECEIVE_QUEUE_ID 型の値。 この識別子は、0 からネットワーク アダプターがサポートするキューの数までの整数値です。 NDIS_DEFAULT_RECEIVE_QUEUE_ID の値は、既定の受信キューを指定します。
QueueGroupId
このメンバーは NDIS 用に予約されています。
QueueState
受信キューの操作状態を指定する NDIS_RECEIVE_QUEUE_OPERATIONAL_STATE 列挙値。
ProcessorAffinity
キューがアフィニティを持つ CPU を指定する GROUP_AFFINITY ビットマップ。 たとえば、設定ビット 0 は CPU 0 が使用されることを示し、設定ビット 1 は CPU 1 が使用されることを示します。 VM キューは 1 つの CPU に関連付けられているため、キューのすべての受信通知がそのプロセッサで処理されます。
NumSuggestedReceiveBuffers
ネットワーク アダプターがキューをサポートするために使用する必要がある受信バッファーの数の推奨値を含む ULONG 値。 この数は、ミニポート ドライバーが使用可能なリソースに対して、またはネットワーク アダプターが他のキューに使用する数に比例して調整できます。 たとえば、実際の受信バッファーの数は、この推奨値の 2 倍または半分にすることができます。
MSIXTableEntry
キューの MSI-X テーブル エントリ インデックスを含む ULONG 値。
LookaheadSize
このキューの先読みサイズ要件のサイズ (バイト単位) の ULONG 値。 VM キューで先読みをサポートするネットワーク アダプターは、受信したパケットを要求された先読みサイズ以上のオフセットで分割し、DMA を使用して先読みデータと先読み後データを共有メモリ セグメントを分離するために転送します。
VmName
仮想マシンのわかりやすい説明を含む NDIS_VM_NAME 値。
QueueName
キューのわかりやすい説明を含む NDIS_QUEUE_NAME 値。
NumFilters
ネットワーク アダプターで構成されている受信フィルターの数を指定する ULONG 値。
InterruptCoalescingDomainId
NDIS で使用するために予約されている ULONG 値。 この値は、ミニポート ドライバーによる情報提供のために使用されます。
備考
NDIS_RECEIVE_QUEUE_INFO 構造体は、の NDIS_RECEIVE_QUEUE_INFO_ARRAY 構造ネットワーク アダプターの受信キューを列挙する OID を OID_RECEIVE_FILTER_ENUM_QUEUES します。
OID_RECEIVE_FILTER_ENUM_QUEUESからの正常な戻りにより、NDIS は受信キュー配列のプロパティを定義する NDIS_RECEIVE_QUEUE_INFO_ARRAY 構造体を提供します。 配列内の各要素は、NDIS_RECEIVE_QUEUE_INFO 構造体です。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | NDIS 6.20 以降でサポートされています。 |
| ヘッダー | ntddndis.h (Ndis.h を含む) |
関連項目
NDIS_RECEIVE_QUEUE_OPERATIONAL_STATEOID_RECEIVE_FILTER_CLEAR_FILTER