structure PATH_OFFLOAD_STATE_CONST (ndischimney.h)

Article
03/01/2024

[La fonctionnalité de déchargement de la cheminée TCP est déconseillée et ne doit pas être utilisée.]

La structure PATH_OFFLOAD_STATE_CONST contient les variables constantes d’un objet d’état de chemin d’accès.

Syntaxe

typedef struct _PATH_OFFLOAD_STATE_CONST {
  OFFLOAD_STATE_HEADER Header;
  const UCHAR          *SourceAddress;
  const UCHAR          *DestinationAddress;
} PATH_OFFLOAD_STATE_CONST, *PPATH_OFFLOAD_STATE_CONST;

Membres

Header

Structure OFFLOAD_STATE_HEADER . NDIS définit le membre Length de Header sur la taille, en octets, de la structure PATH_OFFLOAD_STATE_CONST. Le membre RecognizedOptions de l’en-tête est réservé.

SourceAddress

Pointeur vers l’adresse IP source d’une connexion TCP. Si la connexion TCP est via IPv4, l’adresse est une adresse IPv4 de 4 octets. Si la connexion TCP est via IPv6, l’adresse est une adresse IPv6 de 16 octets. Les octets d’adresse source sont toujours dans l’ordre d’octet réseau.

DestinationAddress

Pointeur vers l’adresse IP de destination d’une connexion TCP. Si la connexion TCP est via IPv4, l’adresse est une adresse IPv4 de 4 octets. Si la connexion TCP est via IPv6, l’adresse est une adresse IPv6 de 16 octets. Les octets d’adresse de destination sont toujours dans l’ordre d’octet réseau.

Remarques

La valeur de chaque variable constante de chemin d’accès ne change pas pendant la durée de vie d’une connexion TCP. Ni la pile hôte ni la cible de déchargement ne modifient les valeurs d’une variable constante de chemin d’accès. Lorsque la pile de l’hôte met fin au déchargement de l’objet d’état du chemin d’accès, ce qui provoque NDIS pour appeler la cible de déchargement Fonction MiniportTerminateOffload , la cible de déchargement ne retourne pas la valeur des variables constantes de chemin d’accès déchargées à la pile hôte.

Lorsqu’elle est passée à une cible de déchargement, une structure PATH_OFFLOAD_STATE_CONST est associée à une NDIS_MINIPORT_OFFLOAD_BLOCK_LIST structure, qui contient un en-tête mis en forme en tant que structure de NDIS_OBJECT_HEADER . Dans ce cas, le membre Revision de la structure NDIS_OBJECT_HEADER spécifie le numéro de révision de la structure PATH_OFFLOAD_STATE_CONST.