NDIS_RESTART_ATTRIBUTES structure (ndis.h)

Article
08/07/2023

La structure NDIS_RESTART_ATTRIBUTES identifie une entrée d’attributs dans une liste liée d’attributs de redémarrage.

Syntaxe

typedef struct _NDIS_RESTART_ATTRIBUTES {
  PNDIS_RESTART_ATTRIBUTES Next;
  NDIS_OID                 Oid;
  ULONG                    DataLength;
  UCHAR                    Data[1];
} NDIS_RESTART_ATTRIBUTES, *PNDIS_RESTART_ATTRIBUTES;

Membres

Next

Pointeur vers une structure NDIS_RESTART_ATTRIBUTES que vous pouvez utiliser pour accéder au jeu suivant d’attributs de redémarrage dans la liste d’attributs liée. S’il n’y a pas d’attributs supplémentaires, ce membre est NULL.

Oid

Identificateur d’objet NDIS pour les informations contenues dans le membre Data . Par exemple, si Oid est OID_GEN_MINIPORT_RESTART_ATTRIBUTES, le membre Data contient un NDIS_RESTART_GENERAL_ATTRIBUTES structure.

DataLength

Longueur, en octets, des informations stockées dans le membre Data .

Data[1]

Mémoire tampon qui contient les informations associées à l’OID spécifié dans le membre Oid .

Remarques

Lorsque NDIS redémarre une pile de pilotes, NDIS transmet un pointeur vers une liste liée d’attributs de redémarrage aux pilotes de miniport, de filtre et de protocole.

Lorsqu’il appelle la fonction MiniportRestart d’un pilote miniport, NDIS transmet un pointeur vers une structure NDIS_RESTART_ATTRIBUTES au pilote miniport dans le membre RestartAttributes du NDIS_MINIPORT_RESTART_PARAMETERS structure.

Quand il appelle la fonction FilterRestart d’un pilote de filtre, NDIS passe un pointeur vers une structure de NDIS_RESTART_ATTRIBUTES au pilote de filtre dans le membre RestartAttributes du NDIS_FILTER_RESTART_PARAMETERS structure.

Lorsqu’il redémarre une liaison de protocole, NDIS fournit un pointeur vers une structure NDIS_RESTART_ATTRIBUTES dans le membre RestartAttributes du NDIS_PROTOCOL_RESTART_PARAMETERS structure. Pour redémarrer une liaison de protocole, NDIS appelle la fonction ProtocolNetPnPEvent d’un pilote de protocole. Membre NetPnPEvent du NET_PNP_EVENT_NOTIFICATION structure, que NDIS transmet à ProtocolNetPnPEvent, contient une structure NET_PNP_EVENT . La structure NET_PNP_EVENT spécifie NetEventRestart dans le membre NetEvent et un pointeur vers la structure NDIS_PROTOCOL_RESTART_PARAMETERS dans le membre Buffer .

Si le pointeur d’attributs de redémarrage que NDIS transmet aux pilotes NDIS est NULL, les pilotes ne doivent pas propager leurs modifications d’attributs dans la pile des pilotes. Dans ce cas, les pilotes ne doivent pas modifier ni signaler de modifications d’attributs.

Si le pointeur d’attributs de redémarrage n’est pas NULL, la liste liée des structures NDIS_RESTART_ATTRIBUTES comporte au moins une entrée qui contient un NDIS_RESTART_GENERAL_ATTRIBUTES structure. Le reste des entrées, le cas échéant, contiennent des attributs spécifiques au média.