NDIS_NDK_CONNECTIONS-Struktur (ntddndis.h)

  • Artikel

Die NDIS_NDK_CONNECTIONS-Struktur beschreibt die NDK-Verbindungen, die auf einem Miniportadapter aktiv sind.

Syntax

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

Member

Header

Eine NDIS_OBJECT_HEADER-Struktur , die diese NDIS_NDK_CONNECTIONS-Struktur beschreibt. Legen Sie die Member der NDIS_OBJECT_HEADER-Struktur wie folgt fest:

  • Legen Sie das Element Typ auf NDIS_OBJECT_TYPE_DEFAULT fest.
  • Legen Sie den Revisionsmember auf NDIS_NDK_CONNECTIONS_REVISION_1 fest.
  • Legen Sie das Element Größe auf (USHORT)min(MAXUSHORT, NDIS_SIZEOF_NDK_CONNECTIONS_REVISION_1(n)) fest.

Flags

Count

Die Anzahl der Elemente im Verbindungsarray, die im Connections-Member übergeben wird. Jedes Element im Array ist eine NDIS_NDK_CONNECTION_ENTRY-Struktur .

NDConnectionsMappedtoTCPConnections

Ein BOOLESCHER Wert, der angibt, wie die Verbindungen zugeordnet werden. Wenn die RDMA-Technologie für den NDK-Anbieter erfordert, dass der Anbieter ND-Verbindungen TCP-Verbindungen zuordnen muss, muss der NDK-Anbieter das Element NDConnectionsMappedtoTCPConnections auf TRUE festlegen. Andernfalls ist NDConnectionsMappedtoTCPConnections FALSE.

Connections[1]

Ein Array mit variabler Größe NDIS_NDK_CONNECTION_ENTRY Strukturen, bei denen die Größe des Arrays durch die Anzahl der zurückgegebenen Verbindungen bestimmt wird. Der Count-Member gibt die Anzahl der Elemente im Verbindungsarray an.

Hinweise

Die NDIS_NDK_CONNECTIONS-Struktur wird mit der OID_NDK_CONNECTIONS OID zurückgegeben. Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf diese Struktur.

Diese Struktur hat eine variable Größe und enthält Elemente, die der Anzahl der zurückgegebenen Verbindungen entsprechen. Die tatsächliche Größe des Verbindungsarrays als Elementanzahl wird durch den Count-Member angegeben.

Wenn die RDMA-Technologie für den NDK-Anbieter erfordert, dass der Anbieter ND-Verbindungen TCP-Verbindungen zuzuordnen, muss der NDK-Anbieter auch das zugrunde liegende 4-Tupel der TCP-Verbindung für jede ND-Verbindung wie folgt melden:

  • Legen Sie das Element NDConnectionsMappedtoTCPConnections auf TRUE fest.
  • Verwenden Sie zwei aufeinander folgende Einträge für jede ND-Verbindung. Der erste Eintrag enthält die ND-Adressierungsinformationen (lokale und Remote-IP-Adresse und ND-Portnummer), und der unmittelbare nächste Eintrag enthält die Adressierungsinformationen der entsprechenden TCP-Verbindung (lokale und Remote-IP-Adresse und TCP-Portnummer).
  • Andere Member als Adressierungsinformationen (z. B . UserModeOwner und OwnerPid) dürfen nur im ersten Eintrag festgelegt und im nächsten Eintrag unverändert bleiben. Daher enthalten Einträge am Index 0, 2, 4 usw. ND-Adressinformationen (plus ordnungsgemäß ausgefüllten anderen Membern) und Einträge am Index 1, 3, 5 usw. TCP-Adressinformationen (wobei andere Member unberührt bleiben).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Keine unterstützt, unterstützt in NDIS 6.30 und höher.
Unterstützte Mindestversion (Server) Windows Server 2012
Kopfzeile ntddndis.h (include Ndis.h)

Weitere Informationen

NDIS_NDK_CONNECTION_ENTRY

NDIS_OBJECT_HEADER

OID_NDK_CONNECTIONS