NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS Struktur (ntddndis.h)

Artikel
02/07/2025

Die NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS Struktur gibt die Parameter für die benutzerdefinierten Statusinformationen eines Hyper-V erweiterbaren Switchports an. Diese Informationen werden als Featurestatus Informationen bezeichnet. Das Format dieser Informationen wird vom unabhängigen Softwareanbieter (ISV) definiert.

Die Statusinformationen werden über eine NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM Struktur angegeben und über eine OID-Methodenanforderung von OID_SWITCH_PORT_FEATURE_STATUS_QUERYzurückgegeben.

Syntax

typedef struct _NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_FEATURE_STATUS_TYPE     FeatureStatusType;
  NDIS_SWITCH_OBJECT_ID                    FeatureStatusId;
  NDIS_SWITCH_OBJECT_VERSION               FeatureStatusVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           FeatureStatusInstanceId;
  ULONG                                    FeatureStatusBufferLength;
  ULONG                                    FeatureStatusBufferOffset;
  ULONG                                    Reserved;
} NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS, *PNDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS;

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der NDIS_SWITCH_PORT_FEATURE_STATUS_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_FEATURE_STATUS_PARAMETERS-Struktur anzugeben, muss der Revision Member der Header- auf den folgenden Wert festgelegt werden:

NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie das Size Member auf NDIS_SIZEOF_NDIS_SWITCH_PORT_FEATURE_STATUS_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 numerischen Bezeichner für einen erweiterbaren Switchport angibt. Dieser Wert identifiziert den Port auf dem erweiterbaren Switch eindeutig, für den Funktionsstatusinformationen zurückgegeben werden sollen.

FeatureStatusType

Ein NDIS_SWITCH_PORT_FEATURE_STATUS_TYPE Enumerationswert, der den Typ der Statusinformationen für eine benutzerdefinierte erweiterbare Switchportprofileigenschaft angibt.

Hinweis Ab NDIS 6.30 muss dieses Element auf NdisSwitchPortPropertyTypeCustomfestgelegt werden.

FeatureStatusId

Ein NDIS_SWITCH_OBJECT_ID Wert, der die Profileigenschaft für den erweiterbaren Switchport identifiziert.

FeatureStatusVersion

Ein NDIS_SWITCH_OBJECT_VERSION Wert, der die Version der Profileigenschaft für den erweiterbaren Switchport identifiziert.

SerializationVersion

Ein NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION Wert, der die Formatversion der serialisierten Porteigenschaftendaten identifiziert. Diese Daten werden für den Zugriff durch die Erweiterung aus der MOF-Datei (Managed Object Format) serialisiert, die die Eigenschaft definiert hat.

Hinweis Für Windows Server 2012 muss das SerializationVersion-Mitglied auf NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1 festgelegt sein.

FeatureStatusInstanceId

Ein NDIS_SWITCH_OBJECT_INSTANCE_ID Wert, der die Instanz der Featurestatusinformationen für den erweiterbaren Switchport identifiziert.

FeatureStatusBufferLength

Ein ULONG-Wert, der die Größe des Featurestatuspuffers in Bytes angibt.

FeatureStatusBufferOffset

Ein ULONG-Wert, der den Offset in Byte angibt, an den Featurestatuspuffer, der auf die NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS Struktur folgt. Der Featurestatuspuffer enthält eine NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM Struktur.

Der Offset wird vom Anfang der NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS Struktur bis zum Anfang der NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM Struktur gemessen.

Reserved

Reserviert für die zukünftige Verwendung.

Bemerkungen

Die NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS Struktur wird in OID-Methodenanforderungen von OID_SWITCH_PORT_FEATURE_STATUS_QUERYverwendet. Diese OID-Anforderung gibt die folgenden Strukturen im Informationspuffer zurück, die der OID-Anforderung zugeordnet sind:

Eine NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS Struktur, die die Parameter für eine benutzerdefinierte Eigenschaft eines erweiterbaren Switchports angibt, für die Statusinformationen zurückgegeben werden sollen. Die Switcherweiterung füllt die FeatureStatusVersion Member der Struktur auf, um die Version des benutzerdefinierten Status widerzuspiegeln, der im NDIS_SWITCH_FEATURE_STATUS_CUSTOM Puffer zurückgegeben wird. Der Hyper-v Extensible-Schalter füllt alle anderen Member auf, wenn die Abfrage-OID ausgestellt wird.
Eine NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM Struktur, die die Statusinformationen für die erweiterbare Switchporteigenschaft enthält. Die Switcherweiterung füllt die FeatureStatusCustomBufferLength Element der Struktur auf, um die Größe des zurückgegebenen benutzerdefinierten Status widerzuspiegeln. Der Hyper-v Extensible-Schalter füllt alle anderen Member auf, wenn die Abfrage-OID ausgestellt wird.