NDIS_NDK_CONNECTIONS 結構 (ntddndis.h)

NDIS_NDK_CONNECTIONS結構描述迷你埠配接器上作用中的 NDK 連線。

語法

typedef struct _NDIS_NDK_CONNECTIONS {
  NDIS_OBJECT_HEADER        Header;
  ULONG                     Flags;
  ULONG                     Count;
  BOOLEAN                   NDConnectionsMappedtoTCPConnections;
  NDIS_NDK_CONNECTION_ENTRY Connections[1];
} NDIS_NDK_CONNECTIONS;

成員

Header

描述此NDIS_NDK_CONNECTIONS結構的NDIS_OBJECT_HEADER結構。 設定 NDIS_OBJECT_HEADER 結構的成員，如下所示：

• 將 Type 成員設定為 NDIS_OBJECT_TYPE_DEFAULT。
• 將 [修訂 成員] 設定為 [NDIS_NDK_CONNECTIONS_REVISION_1]。
• 將 Size 成員設定為 (USHORT) min (MAXUSHORT，NDIS_SIZEOF_NDK_CONNECTIONS_REVISION_1 (n) ) 。

Flags

Count

在連接數位中傳入 Connections 成員的項目數。 陣列中的每個元素都是 NDIS_NDK_CONNECTION_ENTRY 結構。

NDConnectionsMappedtoTCPConnections

指定連接對應方式的 BOOLEAN 值。 如果 NDK 提供者的 RDMA 技術需要提供者將 ND 連線對應至 TCP 連線，NDK 提供者必須將 NDConnectionsMappedtoTCPConnections 成員設定為 TRUE。 否則， NDConnectionsMappedtoTCPConnections 為 FALSE。

Connections[1]

NDIS_NDK_CONNECTION_ENTRY 結構的可變 大小數位，其中陣列的大小取決於所傳回的連接數目。 Count 成員會指定連接陣列中的項目數目。

備註

NDIS_NDK_CONNECTIONS結構會以 OID_NDK_CONNECTIONS OID 傳回。 NDIS_OID_REQUEST 結構的 InformationBuffer 成員包含這個 結構的指標。

此結構是可變大小的，且包含與傳回的連接數目相等的專案。 以專案計數表示連接數位的實際大小是由 Count 成員表示。

如果 NDK 提供者的 RDMA 技術需要提供者將 ND 連線對應至 TCP 連線，NDK 提供者也必須針對每個 ND 連線報告基礎 TCP 連線 4-Tuple，如下所示：

• 將 NDConnectionsMappedtoTCPConnections 成員設定為 TRUE。
• 針對每個 ND 連線使用兩個連續專案。 第一個專案包含本機和遠端 IP 位址 (ND 尋址資訊，而 ND 埠號碼) ，而下一個專案則包含對應 TCP 連線的尋址資訊 (本機和遠端 IP 位址，以及 TCP 連接埠號碼) 。
• 尋址資訊以外的成員 (例如， UserModeOwner 和 OwnerPid) 必須設定在第一個專案中，且在下一個專案中未變更。 因此，索引 0、2、4 等的專案會包含 ND 尋址資訊， (加上適當填入其他成員) ，以及索引 1、3、5 等的專案，包含 TCP 尋址資訊 (其中其他成員未變更) 。

規格需求

需求	值
最低支援的用戶端	NDIS 6.30 和更新版本中不支援，不支援。
最低支援的伺服器	Windows Server 2012
標頭	ntddndis.h (包含 Ndis.h)

另請參閱

NDIS_NDK_CONNECTION_ENTRY

NDIS_OBJECT_HEADER

OID_NDK_CONNECTIONS