NDIS_PROTOCOL_RESTART_PARAMETERS-Struktur (ndis.h)

  • Artikel

Die NDIS_PROTOCOL_RESTART_PARAMETERS-Struktur definiert Neustartparameter für einen Protokolltreiber, wenn NDIS die ProtocolNetPnPEvent-Funktion aufruft, um ein NetEventRestart-Ereignis anzugeben.

Syntax

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;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die NDIS_PROTOCOL_RESTART_PARAMETERS-Struktur. NDIS legt das Type-Element der Struktur, die Header angibt, auf NDIS_OBJECT_TYPE_PROTOCOL_RESTART_PARAMETERS, das Revisionselement auf NDIS_PROTOCOL_RESTART_PARAMETERS_REVISION_1 und das Size-Element auf NDIS_SIZEOF_PROTOCOL_RESTART_PARAMETERS_REVISION_1 fest.

FilterModuleNameBuffer

Eine Liste der Namen der zugrunde liegenden Filtermodule. Für jeden Namen enthält der Puffer einen USHORT-Wert gefolgt von einer breit angelegten Zeichenfolge. Verwenden Sie den ersten USHORT-Wert im Puffer, um die Länge der ersten Zeichenfolge zu bestimmen. Verwenden Sie die Länge der ersten Zeichenfolge, um den Anfang der nächsten Zeichenfolge zu bestimmen. Fahren Sie auf diese Weise fort, bis die Anzahl der Bytes, die aus dem Puffer abgerufen werden, der Anzahl der Bytes entspricht, die im Element FilterModuleNameBufferLength angegeben sind.

FilterModuleNameBufferLength

Die Länge des Puffers im Element FilterModuleNameBuffer in Bytes.

RestartAttributes

Ein Zeiger auf den ersten Eintrag in einer Liste von NDIS_RESTART_ATTRIBUTES Strukturen. Verwenden Sie das Nächste Element der NDIS_RESTART_ATTRIBUTES-Struktur, um die nächste Struktur in der Liste abzurufen.

BoundIfIndex

Der NDIS-Netzwerkschnittstellenindex der Schnittstelle der höchsten Ebene, die auf dem Miniportadapter gestapelt ist. Das heißt, wenn virtuelle Miniports oder Filtermodule über den Miniportadapter installiert werden, ist dieser Member der IfIndex des virtuellen Miniports oder Filtermoduls der höchsten Ebene.

BoundIfNetluid

Der NDIS-NET_LUID -Wert (der auch der Netzwerkschnittstellenname (ifName in RFC 2863)) der höchsten Schnittstelle ist, die auf dem Miniportadapter gestapelt ist. Das heißt, wenn virtuelle Miniports oder Filtermodule über den Miniportadapter installiert sind, ist dieser Member der NET_LUID Wert des virtuellen Miniports oder Filtermoduls der höchsten Ebene.

Flags

Für die zukünftige Verwendung reserviert.

Bemerkungen

NDIS übergibt eine NDIS_PROTOCOL_RESTART_PARAMETERS-Struktur an einen Protokolltreiber, wenn die ProtocolNetPnPEvent-Funktion aufgerufen wird, um ein NetEventRestart-Ereignis anzugeben.

Jeder Name, der im Puffer im FilterModuleNameBuffer-Member angegeben wird, ist nicht garantiert, dass er NULL-beendet ist. Der USHORT-Wert am Anfang jeder Zeichenfolge enthält die Länge der Zeichenfolge in Bytes. Protokolltreiber sollten den Wert des Elements FilterModuleNameBufferLength überprüfen, bevor sie auf den Puffer zugreifen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt in NDIS 6.0 und höher.
Kopfzeile ndis.h (einschließlich Ndis.h)

Weitere Informationen

NDIS_OBJECT_HEADER

NDIS_RESTART_ATTRIBUTES

ProtocolNetPnPEvent