NDIS_SWITCH_PARAMETERS-Struktur (ntddndis.h)

Artikel
08/07/2023

Die NDIS_SWITCH_PARAMETERS-Struktur enthält die Konfigurationsdaten für einen erweiterbaren Hyper-V-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;

Member

Header

Typ, Revision und Größe der NDIS_SWITCH_PARAMETERS-Struktur . Dieser Member ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Das Type-Element von Header muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden. Um die Version der NDIS_SWITCH_PARAMETERS-Struktur anzugeben, muss der Revisionsmember von Header auf den folgenden Wert festgelegt werden:

NDIS_SWITCH_PARAMETERS_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie das Element Größe auf NDIS_SIZEOF_NDIS_SWITCH_PARAMETERS_REVISION_1 fest.

Flags

Ein ULONG-Wert, der ein bitweises OR von Flags enthält. Dieser Member ist für NDIS reserviert.

SwitchName

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

Der name des internen Switches wird von WMI-basierten Richtlinienverwaltungsanwendungen verwendet. Weitere Informationen finden Sie unter Verwalten von Hyper-V-Erweiterbaren Switch-Richtlinien.

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 für den erweiterbaren Switch konfiguriert sind.

IsActive

Ein BOOLEscher Wert, der bei TRUE angibt, dass die Aktivierung des erweiterbaren Hyper-V-Switches abgeschlossen ist und es sicher ist, andere Switchkonfigurationen wie das Aufzählen von Ports, NICs und Eigenschaften abzufragen. Bei FALSE muss die Erweiterung warten, bis das NetEventSwitchActivate-PNP-Ereignis ausgegeben wird, bevor die Switchkonfiguration abgefragt wird.

Hinweise

Die NDIS_SWITCH_PARAMETERS-Struktur wird in der OID-Anforderung von OID_SWITCH_PARAMETERS verwendet.

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

Hinweis Die Datentypen NDIS_SWITCH_NAME und NDIS_SWITCH_FRIENDLYNAME werden vom Typ der IF_COUNTED_STRING-Struktur definiert. Eine Zeichenfolge, die von dieser Struktur definiert wird, muss nicht NULL-endend sein. Die Länge der Zeichenfolge muss jedoch im Length-Member dieser Struktur festgelegt werden. Wenn die Zeichenfolge NULL-endend ist, darf der Length-Member nicht das abschließende NULL-Zeichen enthalten.