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) |