NDIS_IPSEC_OFFLOAD_V2_TUNNEL_NET_BUFFER_LIST_INFO-Struktur (ndis.h)

Artikel
08/07/2023

[Das IPsec-Aufgabenauslagerungsfeature ist veraltet und sollte nicht verwendet werden.]

Die NDIS_IPSEC_OFFLOAD_V2_TUNNEL_NET_BUFFER_LIST_INFO-Struktur gibt das Sicherheitszuordnungs-Auslagerungshandle (Security Association, SA) an den Tunnelteil eines Sendepakets an.

Syntax

typedef struct _NDIS_IPSEC_OFFLOAD_V2_TUNNEL_NET_BUFFER_LIST_INFO {
  struct {
    NDIS_HANDLE TunnelHandle;
  } Transmit;
} NDIS_IPSEC_OFFLOAD_V2_TUNNEL_NET_BUFFER_LIST_INFO, *PNDIS_IPSEC_OFFLOAD_V2_TUNNEL_NET_BUFFER_LIST_INFO;

Member

Transmit

Eine Struktur, die die folgenden Member enthält:

Transmit.TunnelHandle

Der Tunnel-SA-Handle im Transport über den Tunnel.

Hinweise

Bevor der TCP/IP-Transport ein Sendepaket übergibt, das eine NIC Aufgaben der Version 2 (Internetprotokollsicherheit) (IPsecOV2) an den Miniporttreiber der NIC ausführt, aktualisiert der Transport die IPsec-Informationen in der NDIS_IPSEC_OFFLOAD_V2_NET_BUFFER_LIST_INFO Struktur, die der NET_BUFFER_LIST-Struktur zugeordnet ist.

Der TCP/IP-Transport stellt ein Handle im OffloadHandle-Member von NDIS_IPSEC_OFFLOAD_V2_NET_BUFFER_LIST_INFO bereit, das das Handle für die ausgehende SA für den Transportteil (End-to-End-Verbindung) des Sendepakets angibt. Wenn das Sendepaket über einen Tunnel übertragen wird, stellt der TCP/IP-Transport auch eine NDIS_IPSEC_OFFLOAD_V2_TUNNEL_NET_BUFFER_LIST_INFO-Struktur bereit. Diese Struktur gibt das Auslagerungshandle an die ausgehende SA für den Tunnelteil des Sendepakets an.

Der TunnelHandle-Wert , der in der NDIS_IPSEC_OFFLOAD_V2_TUNNEL_NET_BUFFER_LIST_INFO-Struktur bereitgestellt wird, weist den gleichen Wert wie der OffloadHandle auf, der an den TCP/IP-Transport gemeldet wurde, als der Miniporttreiber erfolgreich eine Gruppe von SAs zu einer NIC hinzugefügt hat. Alle SAs wurden hinzugefügt, wenn der Miniporttreiber auf den OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA Anforderung.

Verwenden Sie zum Festlegen und Abrufen der IPsec-Tunnelinformationen den Index IPsecOffloadV2TunnelNetBufferListInfo mit dem NET_BUFFER_LIST_INFO Makro. NET_BUFFER_LIST_INFO gibt eine NDIS_IPSEC_OFFLOAD_V2_TUNNEL_NET_BUFFER_LIST_INFO-Struktur zurück.