structure NDIS_PROTOCOL_RESTART_PARAMETERS (ndis.h)
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 pour la structure NDIS_PROTOCOL_RESTART_PARAMETERS. NDIS définit le membre type de la structure spécifiée par Header 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és dans le FilterModuleNameBufferLength membre.
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 de l’interface réseau NDIS 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 IfIndex du miniport virtuel ou du module de filtre virtuel le plus haut niveau.
BoundIfNetluid
Valeur nDIS NET_LUID (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 miniport virtuel ou du module de filtre le plus haut niveau.
Flags
Réservé pour une utilisation ultérieure.
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 dans l'FilterModuleNameBuffer membre n’est pas garanti comme se terminant par 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 vérifier la valeur du membre FilterModuleNameBufferLength avant d’accéder à la mémoire tampon.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge dans NDIS 6.0 et versions ultérieures. |
| d’en-tête | ndis.h (include Ndis.h) |