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 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) |