NDIS_RESTART_ATTRIBUTES-Struktur (ndis.h)

Artikel
03/01/2024

Die NDIS_RESTART_ATTRIBUTES-Struktur identifiziert einen Attributeintrag in einer verknüpften Liste von Neustartattributen.

Syntax

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

Member

Next

Ein Zeiger auf eine NDIS_RESTART_ATTRIBUTES Struktur, die Sie verwenden können, um auf den nächsten Satz von Neustartattributen in der verknüpften Liste der Attribute zuzugreifen. Wenn keine zusätzlichen Attribute vorhanden sind, ist dieser Member NULL.

Oid

Der NDIS-Objektbezeichner für die Informationen, die sich im Data-Member befindet. Wenn z. B. Oid ist OID_GEN_MINIPORT_RESTART_ATTRIBUTES enthält das Datenelement ein NDIS_RESTART_GENERAL_ATTRIBUTES Struktur.

DataLength

Die Länge der Im Datenmember gespeicherten Informationen in Bytes.

Data[1]

Ein Puffer, der die Informationen enthält, die der OID zugeordnet sind, die im Oid-Member angegeben ist.

Hinweise

Wenn NDIS einen Treiberstapel neu startet, übergibt NDIS einen Zeiger auf eine verknüpfte Liste von Neustartattributen an Miniport-, Filter- und Protokolltreiber.

Wenn die MiniportRestart-Funktion eines Miniporttreibers aufgerufen wird, übergibt NDIS einen Zeiger auf eine NDIS_RESTART_ATTRIBUTES-Struktur an den Miniporttreiber im RestartAttributes-Member des NDIS_MINIPORT_RESTART_PARAMETERS Struktur.

Wenn die FilterRestart-Funktion eines Filtertreibers aufgerufen wird, übergibt NDIS einen Zeiger auf eine NDIS_RESTART_ATTRIBUTES Struktur an den Filtertreiber im RestartAttributes-Member des NDIS_FILTER_RESTART_PARAMETERS Struktur.

Wenn eine Protokollbindung neu gestartet wird, stellt NDIS einen Zeiger auf eine NDIS_RESTART_ATTRIBUTES Struktur im RestartAttributes-Member des NDIS_PROTOCOL_RESTART_PARAMETERS Struktur. Um eine Protokollbindung neu zu starten, ruft NDIS die ProtocolNetPnPEvent-Funktion eines Protokolltreibers auf. Das NetPnPEvent-Element des NET_PNP_EVENT_NOTIFICATION Struktur, die NDIS an ProtocolNetPnPEvent übergibt, enthält eine NET_PNP_EVENT-Struktur . Die NET_PNP_EVENT-Struktur gibt NetEventRestart im NetEvent-Element und einen Zeiger auf die NDIS_PROTOCOL_RESTART_PARAMETERS-Struktur im Buffer-Member an.

Wenn der Neustartattributezeiger, den NDIS an NDIS-Treiber übergibt, NULL ist, sollten die Treiber ihre Attribute nicht im Treiberstapel verteilen. In dieser Situation sollten Treiber keine Attributeänderungen ändern oder melden.

Wenn der Zeiger des Neustartattributes nicht NULL ist, enthält die verknüpfte Liste der NDIS_RESTART_ATTRIBUTES Strukturen mindestens einen Eintrag, der einen enthält. NDIS_RESTART_GENERAL_ATTRIBUTES Struktur. Die restlichen Einträge enthalten, sofern vorhanden, medienspezifische Attribute.