NDIS_RESTART_ATTRIBUTES struttura (ndis.h)

Articolo
02/26/2024

La struttura NDIS_RESTART_ATTRIBUTES identifica una voce di attributi in un elenco collegato di attributi di riavvio.

Sintassi

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

Members

Next

Puntatore a una struttura NDIS_RESTART_ATTRIBUTES che è possibile usare per accedere al set successivo di attributi di riavvio nell'elenco collegato di attributi. Se non sono presenti attributi aggiuntivi, questo membro è NULL.

Oid

Identificatore dell'oggetto NDIS per le informazioni presenti nel membro Dati . Ad esempio, se Oid è OID_GEN_MINIPORT_RESTART_ATTRIBUTES, il membro Dati contiene un NDIS_RESTART_GENERAL_ATTRIBUTES struttura.

DataLength

Lunghezza, in byte, delle informazioni archiviate nel membro Dati .

Data[1]

Buffer che contiene le informazioni associate all'OID specificato nel membro Oid .

Commenti

Quando NDIS riavvia uno stack di driver, NDIS passa un puntatore a un elenco collegato di attributi di riavvio a miniport, filtro e driver di protocollo.

Quando chiama una funzione MiniportRestart del driver miniport , NDIS passa un puntatore a una struttura NDIS_RESTART_ATTRIBUTES al driver miniport nel membro RestartAttributes del NDIS_MINIPORT_RESTART_PARAMETERS struttura.

Quando chiama la funzione FilterRestart del driver di filtro, NDIS passa un puntatore a una struttura NDIS_RESTART_ATTRIBUTES al driver di filtro nel membro RestartAttributes del NDIS_FILTER_RESTART_PARAMETERS struttura.

Quando riavvia un'associazione di protocolli, NDIS fornisce un puntatore a una struttura NDIS_RESTART_ATTRIBUTES nel membro RestartAttributes NDIS_PROTOCOL_RESTART_PARAMETERS struttura. Per riavviare un'associazione di protocolli, NDIS chiama la funzione ProtocolNetPnPEvent di un driver di protocollo. Membro NetPnPEvent dell'oggetto NET_PNP_EVENT_NOTIFICATION struttura, che NDIS passa a ProtocolNetPnPEvent, contiene una struttura NET_PNP_EVENT . La struttura NET_PNP_EVENT specifica NetEventRestart nel membro NetEvent e un puntatore alla struttura NDIS_PROTOCOL_RESTART_PARAMETERS nel membro Buffer .

Se il puntatore degli attributi di NDIS passato ai driver NDIS è NULL, i driver non devono propagare i relativi attributi modificano lo stack di driver. In questa situazione, i driver non devono modificare o segnalare eventuali modifiche agli attributi.

Se il puntatore degli attributi di riavvio non è NULL, l'elenco collegato di strutture NDIS_RESTART_ATTRIBUTES ha almeno una voce che contiene un elemento NDIS_RESTART_GENERAL_ATTRIBUTES struttura. Le altre voci, se presenti, contengono attributi specifici del supporto.