NDIS_SWITCH_PORT_PARAMETERS Struktur (ntddndis.h)

Artikel
02/07/2025

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

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der NDIS_SWITCH_PORT_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_PORT_PARAMETERS Struktur anzugeben, muss das element RevisionHeader- auf den folgenden Wert festgelegt werden:

NDIS_SWITCH_PORT_PARAMETERS_REVISION_1

Originalversion 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 ODER von Flags enthält. Dieses Mitglied 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 Managing Hyper-V Extensible Switch Policies.

PortFriendlyName

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

PortType

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

IsValidationPort

Wenn WAHR, gibt einen Port an, der vorübergehend für Test- und Überprüfungszwecke erstellt wird, bevor eine Verbindung mit einem VIRTUELLEN Netzwerkadapter hergestellt wird. Weitere Informationen zu diesem Porttyp finden Sie unter Überprüfungsports.

PortState

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

Bemerkungen

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 innerhalb 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 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.