structure NDIS_PROTOCOL_RESTART_PARAMETERS (ndis.h)

  • Article

La structure NDIS_PROTOCOL_RESTART_PARAMETERS définit les paramètres de redémarrage d’un pilote de protocole lorsque NDIS appelle la fonction ProtocolNetPnPEvent pour indiquer un événement NetEventRestart .

Syntaxe

typedef struct _NDIS_PROTOCOL_RESTART_PARAMETERS {
  NDIS_OBJECT_HEADER       Header;
  PUCHAR                   FilterModuleNameBuffer;
  ULONG                    FilterModuleNameBufferLength;
  PNDIS_RESTART_ATTRIBUTES RestartAttributes;
  NET_IFINDEX              BoundIfIndex;
  NET_LUID                 BoundIfNetluid;
  ULONG                    Flags;
} NDIS_PROTOCOL_RESTART_PARAMETERS, *PNDIS_PROTOCOL_RESTART_PARAMETERS;

Membres

Header

Structure NDIS_OBJECT_HEADER de la structure NDIS_PROTOCOL_RESTART_PARAMETERS. NDIS définit le membre Type de la structure que l’en-tête spécifie sur NDIS_OBJECT_TYPE_PROTOCOL_RESTART_PARAMETERS, le membre Revision sur NDIS_PROTOCOL_RESTART_PARAMETERS_REVISION_1 et le membre Size sur NDIS_SIZEOF_PROTOCOL_RESTART_PARAMETERS_REVISION_1.

FilterModuleNameBuffer

Liste des noms des modules de filtre sous-jacents. Pour chaque nom, la mémoire tampon contient une valeur USHORT suivie d’une chaîne de caractères large. Utilisez la première valeur USHORT dans la mémoire tampon pour déterminer la longueur de la première chaîne. Utilisez la longueur de la première chaîne pour déterminer le début de la chaîne suivante. Continuez de cette façon jusqu’à ce que le nombre d’octets récupérés à partir de la mémoire tampon soit égal au nombre d’octets spécifié dans le membre FilterModuleNameBufferLength .

FilterModuleNameBufferLength

Longueur, en octets, de la mémoire tampon dans le membre FilterModuleNameBuffer .

RestartAttributes

Pointeur vers la première entrée d’une liste de structures NDIS_RESTART_ATTRIBUTES . Utilisez le membre Suivant de la structure NDIS_RESTART_ATTRIBUTES pour obtenir la structure suivante dans la liste.

BoundIfIndex

Index d’interface réseau NDIS de l’interface de niveau supérieur qui est empilée sur l’adaptateur miniport. Autrement dit, s’il existe des miniports virtuels ou des modules de filtre qui sont installés sur l’adaptateur miniport, ce membre est l’ifIndex du module de filtre ou miniport virtuel le plus haut niveau.

BoundIfNetluid

NDIS NET_LUID valeur (qui est également le nom de l’interface réseau (ifName dans RFC 2863)) de l’interface de niveau supérieur empilée sur la carte miniport. Autrement dit, s’il existe des miniports virtuels ou des modules de filtre installés sur l’adaptateur miniport, ce membre est la valeur NET_LUID du module de filtre ou miniport virtuel le plus élevé.

Flags

Réservé pour un usage futur.

Remarques

NDIS transmet une structure NDIS_PROTOCOL_RESTART_PARAMETERS à un pilote de protocole lorsqu’il appelle la fonction ProtocolNetPnPEvent pour indiquer un événement NetEventRestart .

Chaque nom spécifié dans la mémoire tampon du membre FilterModuleNameBuffer n’est pas garanti comme ayant une fin NULL. La valeur USHORT au début de chaque chaîne contient la longueur, en octets, de la chaîne. Les pilotes de protocole doivent case activée la valeur du membre FilterModuleNameBufferLength avant d’accéder à la mémoire tampon.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge dans NDIS 6.0 et versions ultérieures.
En-tête ndis.h (inclure Ndis.h)

Voir aussi

NDIS_OBJECT_HEADER

NDIS_RESTART_ATTRIBUTES

ProtocolNetPnPEvent