NDIS_PROTOCOL_RESTART_PARAMETERS struttura (ndis.h)

La struttura NDIS_PROTOCOL_RESTART_PARAMETERS definisce i parametri di riavvio per un driver di protocollo quando NDIS chiama la funzione ProtocolNetPnPEvent per indicare un evento NetEventRestart .

Sintassi

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;

Members

Header

Struttura NDIS_OBJECT_HEADER per la struttura NDIS_PROTOCOL_RESTART_PARAMETERS. NDIS imposta il membro Type della struttura che Header specifica per NDIS_OBJECT_TYPE_PROTOCOL_RESTART_PARAMETERS, il membro Revision su NDIS_PROTOCOL_RESTART_PARAMETERS_REVISION_1 e il membro Size su NDIS_SIZEOF_PROTOCOL_RESTART_PARAMETERS_REVISION_1.

FilterModuleNameBuffer

Elenco dei nomi dei moduli di filtro sottostanti. Per ogni nome, il buffer contiene un valore USHORT seguito da una stringa di caratteri wide. Utilizzare il primo valore USHORT nel buffer per determinare la lunghezza della prima stringa. Utilizzare la lunghezza della prima stringa per determinare l'inizio della stringa successiva. Continuare in questo modo finché il numero di byte recuperati dal buffer equivale al numero di byte specificati nel membro FilterModuleNameBufferLength .

FilterModuleNameBufferLength

Lunghezza, in byte, del buffer nel membro FilterModuleNameBuffer .

RestartAttributes

Puntatore alla prima voce di un elenco di strutture NDIS_RESTART_ATTRIBUTES . Usare il membro Successivo della struttura NDIS_RESTART_ATTRIBUTES per ottenere la struttura successiva nell'elenco.

BoundIfIndex

Indice dell'interfaccia di rete NDIS dell'interfaccia di livello più alto in pila sulla scheda miniport. Vale a dire, se sono presenti miniport virtuali o moduli di filtro installati sull'adattatore miniport, questo membro è l'IfIndex del modulo miniport virtuale o filtro di livello più alto.

BoundIfNetluid

Il valore NDIS NET_LUID (ovvero anche il nome dell'interfaccia di rete (ifName in RFC 2863) dell'interfaccia di livello più alto in pila sulla scheda miniport. Vale a dire, se sono presenti miniport virtuali o moduli di filtro installati sull'adattatore miniport, questo membro è il valore NET_LUID del modulo miniport virtuale o filtro di livello più alto.

Flags

Riservato per utilizzi futuri.

Commenti

NDIS passa una struttura NDIS_PROTOCOL_RESTART_PARAMETERS a un driver di protocollo quando chiama la funzione ProtocolNetPnPEvent per indicare un evento NetEventRestart .

Ogni nome specificato nel buffer nel membro FilterModuleNameBuffer non è garantito che venga terminato NULL. Il valore USHORT all'inizio di ogni stringa contiene la lunghezza, in byte, della stringa. I driver di protocollo devono controllare il valore del membro FilterModuleNameBufferLength prima di accedere al buffer.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.0 e versioni successive.
Intestazione	ndis.h (includere Ndis.h)

Vedi anche

NDIS_OBJECT_HEADER

NDIS_RESTART_ATTRIBUTES

ProtocolNetPnPEvent