NDIS_PROTOCOL_RESTART_PARAMETERS-Struktur (ndis.h)
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) |