NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS-Struktur (ntddndis.h)

Artikel
08/07/2023

Die NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS-Struktur gibt die Parameter für die benutzerdefinierte status Informationen eines erweiterbaren Hyper-V-Switchports an. Diese Informationen werden als Feature-status-Informationen bezeichnet. Das Format dieser Informationen wird vom unabhängigen Softwareanbieter (Independent Software Vendor, ISV) definiert.

Die status Informationen werden über eine NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM-Struktur angegeben und über eine OID-Methodenanforderung von OID_SWITCH_PORT_FEATURE_STATUS_QUERY zurü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;

Member

Header

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

NDIS_SWITCH_PORT_FEATURE_STATUS_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_FEATURE_STATUS_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 numerischen Bezeichner für einen erweiterbaren Switchport angibt. Dieser Wert identifiziert eindeutig den Port des erweiterbaren Switches, für den status Informationen zurückgegeben werden sollen.

FeatureStatusType

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

Hinweis Ab NDIS 6.30 muss dieser Member auf NdisSwitchPortPropertyTypeCustom festgelegt 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 angibt.

SerializationVersion

Ein NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION Wert, der die Formatversion der Daten der serialisierten Porteigenschaft angibt. 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-Element auf NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1 festgelegt werden.

FeatureStatusInstanceId

Ein NDIS_SWITCH_OBJECT_INSTANCE_ID Wert, der die instance des Features status Informationen für den erweiterbaren Switchport identifiziert.

FeatureStatusBufferLength

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

FeatureStatusBufferOffset

Ein ULONG-Wert, der den Offset in Bytes für das Feature status Puffer angibt, der der NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS-Struktur folgt. Das Feature status Puffers enthält eine NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM-Struktur.

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

Reserved

Für die zukünftige Verwendung reserviert.

Bemerkungen

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

Eine NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS-Struktur, die die Parameter für eine benutzerdefinierte Eigenschaft eines erweiterbaren Switchports angibt, für den status Informationen zurückgegeben werden sollen. Die Switcherweiterung füllt das FeatureStatusVersion-Element der Struktur auf, um die Version der benutzerdefinierten status widerzuspiegeln, die 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 ausgegeben wird.
Eine NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM-Struktur, die die status Informationen für die erweiterbare Switchporteigenschaft enthält. Die Switcherweiterung füllt das FeatureStatusCustomBufferLength-Element der Struktur auf, um die Größe der zurückgegebenen benutzerdefinierten status widerzuspiegeln. Der Hyper-v Extensible-Schalter füllt alle anderen Member auf, wenn die Abfrage-OID ausgegeben wird.