NDIS_SWITCH_PORT_PARAMETERS-Struktur (ntddndis.h)

Artikel
02/26/2024

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

Syntax

typedef struct _NDIS_SWITCH_PORT_PARAMETERS {
  NDIS_OBJECT_HEADER            Header;
  ULONG                         Flags;
  NDIS_SWITCH_PORT_ID           PortId;
  NDIS_SWITCH_PORT_NAME         PortName;
  NDIS_SWITCH_PORT_FRIENDLYNAME PortFriendlyName;
  NDIS_SWITCH_PORT_TYPE         PortType;
  BOOLEAN                       IsValidationPort;
  NDIS_SWITCH_PORT_STATE        PortState;
} NDIS_SWITCH_PORT_PARAMETERS, *PNDIS_SWITCH_PORT_PARAMETERS;

Member

Header

Der Typ, die Revision und die Größe der NDIS_SWITCH_PORT_PARAMETERS Struktur. Dieses Element 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_PORT_PARAMETERS-Struktur anzugeben, muss das Revisionselement von Header auf den folgenden Wert festgelegt werden:

NDIS_SWITCH_PORT_PARAMETERS_REVISION_1

Ursprüngliche Version für NDIS 6.30 und höher.

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

Flags

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

PortId

Ein NDIS_SWITCH_PORT_ID Wert, der den eindeutigen Bezeichner des erweiterbaren Switchports enthält.

PortName

Ein NDIS_SWITCH_PORT_NAME Wert, der den eindeutigen internen Namen des erweiterbaren Switchports angibt.

Der interne Portname wird von WMI-basierten Richtlinienverwaltungsanwendungen verwendet. Weitere Informationen finden Sie unter Verwalten von Hyper-V Extensible Switch-Richtlinien.

PortFriendlyName

Ein NDIS_SWITCH_PORT_FRIENDLYNAME Wert, der die benutzerfreundliche Beschreibung des erweiterbaren Switchports angibt.

PortType

Ein NDIS_SWITCH_PORT_TYPE Wert, der den Typ des erweiterbaren Switchports angibt.

IsValidationPort

Wenn TRUE, gibt einen Port an, der vorübergehend zu Test- und Validierungszwecken erstellt wird, bevor eine VM-Netzwerkadapterverbindung hergestellt wird. Weitere Informationen zu diesem Porttyp finden Sie unter Validierungsports.

PortState

Ein NDIS_SWITCH_PORT_STATE Wert, der den aktuellen Status des Ports angibt.

Hinweise

Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_SWITCH_PORT_PARAMETERS-Struktur für die folgenden OID-Anforderungen:

OID-Abfrageanforderungen von OID_SWITCH_PORT_ARRAY geben eine NDIS_SWITCH_PORT_ARRAY-Struktur zurück, die ein Array von Elementen enthält. Jedes Element ist als NDIS_SWITCH_PORT_PARAMETERS-Struktur formatiert.

Erweiterbare Switcherweiterungen können mithilfe des NDIS_SWITCH_PORT_AT_ARRAY_INDEX Makros auf den Porteigenschaftenpuffer in einer NDIS_SWITCH_PORT_PARAMETERS-Struktur zugreifen.

Hinweis Die Datentypen NDIS_SWITCH_PORT_NAME und NDIS_SWITCH_PORT_FRIENDLYNAME werden durch die IF_COUNTED_STRING-Struktur typdefiniert. Eine Zeichenfolge, die von dieser Struktur definiert wird, muss nicht NULL-endend sein. Die Länge der Zeichenfolge muss jedoch im Length-Element dieser Struktur festgelegt werden. Wenn die Zeichenfolge null-beendet ist, darf das Length-Element das beendende NULL-Zeichen nicht enthalten.