NDIS_RECEIVE_QUEUE_INFO 結構 (ntddndis.h)

發行項
02/26/2024

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 結構。

迷你埠驅動程序必須將 Header 的 Type 成員設定為 NDIS_OBJECT_TYPE_DEFAULT。若要指定NDIS_RECEIVE_QUEUE_INFO結構的版本，驅動程式必須將 Header 的 Revision 成員設定為下列其中一個值：

NDIS_RECEIVE_QUEUE_INFO_REVISION_2

已新增 NDIS 6.30 的其他成員。

注意此結構的修訂 2 僅支援 windows Server Windows Server 2012 和更新版本。

將 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

包含旗標位 OR 的 ULONG 值。此成員會保留給 NDIS。

QueueType

指定接收佇列類型的 NDIS_RECEIVE_QUEUE_TYPE 列舉值。

QueueId

包含接收佇列標識碼 的NDIS_RECEIVE_QUEUE_ID 類型值。此標識碼是介於零與網路適配器支援的佇列數目之間的整數值。 值NDIS_DEFAULT_RECEIVE_QUEUE_ID指定預設接收佇列。

QueueGroupId

此成員會保留給 NDIS。

QueueState

指定接收佇列作業狀態的NDIS_RECEIVE_QUEUE_OPERATIONAL_STATE 列舉值。

ProcessorAffinity

GROUP_AFFINITY位圖，指定佇列具有親和性的 CPU。例如，設定位 0 表示使用 CPU 0、設定位 1 表示使用 CPU 1 等等。因為 VM 佇列與一個 CPU 相關聯，所以佇列的所有接收指示都會在該處理器上處理。

NumSuggestedReceiveBuffers

ULONG 值，其中包含網路適配器應該用來支援佇列之接收緩衝區數目的建議值。這個數目可以相對於迷你埠驅動程式可用的資源，或與網路適配器用於其他佇列的數目成比例調整。例如，實際接收緩衝區數目可能是這個建議值的兩倍或一半。

MSIXTableEntry

ULONG 值，其中包含佇列的 MSI-X 數據表專案索引。

LookaheadSize

此佇列外觀大小需求的 ULONG 值，以位元組為單位。支援 VM 佇列中 lookahead 的網路適配器會分割接收的封包，其位移等於或大於要求的外觀大小，並使用 DMA 來傳輸 lookahead 數據和後置外觀數據，以分隔共用記憶體區段。

注意從 NDIS 6.30 開始，不再支援將封包數據分割成個別的外觀緩衝區。這個成員的值必須設定為零。

VmName

包含虛擬機使用者易記描述 的NDIS_VM_NAME 值。

QueueName

包含佇列使用者易記描述 的NDIS_QUEUE_NAME 值。

NumFilters

ULONG 值，指定已在網路適配器上設定的接收篩選數目。

注意從 NDIS 6.30 開始，迷你埠驅動程式必須針對網路適配器上設定的目前接收篩選器數目維護計數器。每當接收篩選透過 OID 集合要求設定OID_RECEIVE_FILTER_SET_FILTER時，驅動程式都必須遞增計數器。每次透過 OID 集合要求清除接收篩選時，驅動程式也必須遞減計數器 OID_RECEIVE_FILTER_CLEAR_FILTER。

InterruptCoalescingDomainId

保留供 NDIS 使用的 ULONG 值。這個值用於迷你埠驅動程式的資訊用途。