NDIS_MINIPORT_OFFLOAD_BLOCK_LIST structure (ndischimney.h)

Article
08/07/2023

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

La structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST est le bloc de construction de base d’une arborescence d’état de déchargement de cheminée TCP. Une arborescence d’état de déchargement peut contenir une ou plusieurs structures NDIS_MINIPORT_OFFLOAD_BLOCK_LIST.

Syntaxe

typedef struct _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST {
  IN NDIS_OBJECT_HEADER                Header;
  IN _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST *NextBlock;
#if ...
  struct                               _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST;
  IN _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST *DependentBlockList;
#else
  struct                               _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST;
#endif
  OUT NDIS_STATUS                      Status;
  IN PVOID                             NdisReserved[2];
  IN OUT PVOID                         *MiniportOffloadContext;
  IN NDIS_HANDLE                       NdisOffloadHandle;
  IN PVOID                             ProtocolReserved[2];
  IN PVOID                             MiniportReserved[2];
  IN PVOID                             ImReserved[2];
  IN PVOID                             Scratch[2];
  IN PVOID                             SourceHandle;
  IN NDIS_PORT_NUMBER                  PortNumber;
  IN OUT PNET_BUFFER_LIST              NetBufferListChain;
} NDIS_MINIPORT_OFFLOAD_BLOCK_LIST, *PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST;

Membres

Header

En-tête de la structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. L’en-tête est mis en forme en tant que structure NDIS_OBJECT_HEADER . La structure NDIS_OBJECT_HEADER contient le numéro de révision de la structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST, le type d’état de déchargement qui suit immédiatement la structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST en mémoire et la taille de la structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST, y compris l’en-tête, en octets.

Le membre Type de la structure NDIS_OBJECT_HEADER indique le type d’état de déchargement et, par conséquent, la ou les structures d’état de déchargement spécifiques qui suivent immédiatement la structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST en mémoire.

Les valeurs OFFLOAD_STATE_TYPE suivantes sont prises en charge :

NeighborOffloadConstState

Spécifie l’état voisin constant. Cet état est au format NEIGHBOR_OFFLOAD_STATE_CONST structure.

NeighborOffloadCachedState

Spécifie l’état voisin mis en cache. Cet état est au format NEIGHBOR_OFFLOAD_STATE_CACHED structure.

NeighborOffloadDelegatedState

Spécifie l’état voisin délégué. Cet état est au format NEIGHBOR_OFFLOAD_STATE_DELEGATED structure.

NeighborOffloadState

Spécifie toutes les informations d’état voisin, y compris la constante, l’état du voisin mis en cache et l’état voisin délégué. Cet état est mis en forme en tant que structure NEIGHBOR_OFFLOAD_STATE_CONST, suivie d’une structure NEIGHBOR_OFFLOAD_STATE_CACHED, puis d’une structure NEIGHBOR_OFFLOAD_STATE_DELEGATED.

Ip4OffloadConstState

Spécifie l’état du chemin d’accès constant (IPv4). Cet état est au format PATH_OFFLOAD_STATE_CONST structure.

Ip4OffloadCachedState

Spécifie l’état du chemin mis en cache (IPv4). Cet état est au format PATH_OFFLOAD_STATE_CACHED structure.

Ip4OffloadDelegatedState

Spécifie l’état du chemin délégué (IPv4). Cet état est au format PATH_OFFLOAD_STATE_DELEGATED structure. Actuellement, il n’existe aucun état de chemin délégué. La structure PATH_OFFLOAD_STATE_DELEGATED ne contient aucune variable.

Ip4OffloadState

Spécifie tout l’état du chemin d’accès (IPv4), y compris la constante, l’état mis en cache et l’état du chemin délégué. Cet état est mis en forme comme structure PATH_OFFLOAD_STATE_CONST, suivie d’une structure PATH_OFFLOAD_STATE_CACHED, puis d’une structure PATH_OFFLOAD_STATE_DELEGATED.

Ip6OffloadConstState

Spécifie l’état du chemin d’accès constant (IPv6). Cet état est mis en forme en tant que structure PATH_OFFLOAD_STATE_CONST.

Ip6OffloadCachedState

Spécifie l’état du chemin mis en cache (IPv6). Cet état est mis en forme en tant que structure PATH_OFFLOAD_STATE_CACHED.

Ip6OffloadDelegatedState

Spécifie l’état du chemin délégué (IPv6). Cet état est mis en forme en tant que structure PATH_OFFLOAD_STATE_DELEGATED. Actuellement, il n’existe aucun état de chemin délégué. La structure PATH_OFFLOAD_STATE_DELEGATED ne contient aucune variable.

Ip6OffloadState

Spécifie toutes les informations d’état du chemin d’accès (IPv6), y compris la constante, l’état du chemin d’accès mis en cache et délégué. Cet état est mis en forme comme structure PATH_OFFLOAD_STATE_CONST, suivie d’une structure PATH_OFFLOAD_STATE_CACHED, puis d’une structure PATH_OFFLOAD_STATE_DELEGATED.

TcpOffloadConstState

Spécifie l’état TCP constant. Cet état est au format TCP_OFFLOAD_STATE_CONST structure.

TcpOffloadCachedState

Spécifie l’état TCP mis en cache. Cet état est au format TCP_OFFLOAD_STATE_CACHED structure.

TcpOffloadDelegatedState

Spécifie l’état TCP délégué. Cet état est au format TCP_OFFLOAD_STATE_DELEGATED structure.

TcpOffloadResourceState

Réservé. Cette valeur de OFFLOAD_STATE_TYPE, ainsi que la structure TCP_OFFLOAD_RESOURCE_STATE, ne sont pas utilisées actuellement.

TcpOffloadState

Spécifie toutes les informations d’état TCP, y compris la constante, l’état TCP mis en cache et délégué. Cet état est mis en forme en tant que structure TCP_OFFLOAD_STATE_CONST, suivie d’une structure TCP_OFFLOAD_STATE_CACHED, puis d’une structure TCP_OFFLOAD_STATE_DELEGATED.

FilterReservedOffloadState

Réservé aux pilotes de filtre.

NextBlock

Pointeur vers la structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST suivante au niveau de la couche d’état de déchargement (voisin, chemin ou TCP) indiquée par le membre Type du membre Header . NDIS_MINIPORT_OFFLOAD_BLOCK_LIST structures liées via des pointeurs NextBlock sont toujours au même niveau de l’état de déchargement. Une valeur NextBlocknull indique qu’il n’existe aucune structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST suivante supplémentaire à ce niveau.

_NDIS_MINIPORT_OFFLOAD_BLOCK_LIST

DependentBlockList

Pointeur vers une structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST qui se trouve au niveau d’une couche dépendante de l’état de déchargement (couche supérieure dans l’arborescence d’état de déchargement). Pour le déchargement de cheminée TCP :

Le membre DependentBlockList d’une structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST au niveau de la couche voisine peut pointer uniquement vers une structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST au niveau de la couche de chemin.
Le membre DependentBlockList d’une structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST au niveau de la couche de chemin d’accès peut pointer uniquement vers une structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST au niveau de la couche TCP.
Le membre DependentBlockList d’une structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST au niveau de la couche TCP est toujours NULL.

Une valeur DependentBlockListnull indique qu’il n’existe aucune structure de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST dépendante.

Status

L’achèvement status d’une opération de lancement de déchargement, de déchargement de requête, de mise à jour du déchargement, d’invalidation du déchargement ou d’arrêt de déchargement effectuée par la cible de déchargement sur l’état associé à la structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST ou référencé par celui-ci. Selon l’opération, la cible de déchargement écrit l’une des valeurs NDIS_STATUS suivantes dans le membre Status :

NDIS_STATUS_SUCCESS

Lancer le déchargement : la cible de déchargement a correctement déchargé l’état associé à la structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST et l’état associé à toutes les structures de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST immédiatement dépendantes.

Interroger, mettre à jour, invalider ou arrêter le déchargement : la cible de déchargement a correctement effectué l’opération sur l’état associé à la structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST ou référencé par.

NDIS_STATUS_OFFLOAD_PARTIAL_SUCCESS

Lancement du déchargement : la cible de déchargement a correctement déchargé l’état associé à la structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST, mais n’a pas pu décharger l’état associé à une ou plusieurs des structures NDIS_MINIPORT_OFFLOAD_BLOCK_LIST immédiatement dépendantes.