NDIS_SWITCH_PARAMETERS Struktur (ntddndis.h)

Artikel
02/07/2025

Die NDIS_SWITCH_PARAMETERS-Struktur enthält die Konfigurationsdaten für einen Hyper-V erweiterbaren Switch.

Syntax

typedef struct _NDIS_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    Flags;
  NDIS_SWITCH_NAME         SwitchName;
  NDIS_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  UINT32                   NumSwitchPorts;
  BOOLEAN                  IsActive;
} NDIS_SWITCH_PARAMETERS, *PNDIS_SWITCH_PARAMETERS;

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der NDIS_SWITCH_PARAMETERS Struktur. Dieses Element ist als NDIS_OBJECT_HEADER Struktur formatiert.

Das element TypeHeader muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden. Um die Version der NDIS_SWITCH_PARAMETERS-Struktur anzugeben, muss der Revision Member Header- auf den folgenden Wert festgelegt werden:

NDIS_SWITCH_PARAMETERS_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie das Size Member auf NDIS_SIZEOF_NDIS_SWITCH_PARAMETERS_REVISION_1 fest.

Flags

Ein ULONG-Wert, der ein bitweises ODER von Flags enthält. Dieses Mitglied ist für NDIS reserviert.

SwitchName

Ein NDIS_SWITCH_NAME Wert, der den eindeutigen internen Namen des erweiterbaren Schalters angibt.

Der name des internen Switches wird von WMI-basierten Richtlinienverwaltungsanwendungen verwendet. Weitere Informationen finden Sie unter Managing Hyper-V Extensible Switch Policies.

SwitchFriendlyName

Ein NDIS_SWITCH_FRIENDLYNAME Wert, der die benutzerfreundliche Beschreibung des erweiterbaren Schalters angibt.

NumSwitchPorts

Ein UINT32-Wert, der die Anzahl der Ports angibt, die auf dem erweiterbaren Switch konfiguriert sind.

IsActive

Ein BOOLESCHER Wert, der angibt, dass die Aktivierung des erweiterbaren Switches Hyper-V abgeschlossen ist, und es ist sicher, nach anderen Switchkonfigurationen wie dem Aufzählen von Ports, NICs und Eigenschaften abzufragen. Wenn FALSE, muss die Erweiterung warten, bis das NetEventSwitchActivate PNP-Ereignis ausgegeben wird, bevor die Switchkonfiguration abgefragt wird.If FALSE, the extension must wait for the NetEventSwitchActivate PNP event to be issued before querying for switch configuration.

Bemerkungen

Die NDIS_SWITCH_PARAMETERS Struktur wird in der OID-Anforderung von OID_SWITCH_PARAMETERSverwendet.

Diese Struktur wird auch im vSwitch Parameter der folgenden Legendenfunktionen für Popuptreiber der Windows-Filterplattform übergeben:

Hinweis Die Datentypen NDIS_SWITCH_NAME und NDIS_SWITCH_FRIENDLYNAME werden durch die IF_COUNTED_STRING-Struktur typdefiniert. Eine durch diese Struktur definierte Zeichenfolge muss nicht null beendet werden. Die Länge der Zeichenfolge muss jedoch im Length Member dieser Struktur festgelegt werden. Wenn die Zeichenfolge null-beendet ist, darf das element Length nicht das endende Nullzeichen enthalten.