NDIS_SWITCH_FEATURE_STATUS_PARAMETERS Struktur (ntddndis.h)

Artikel
02/07/2025

Die NDIS_SWITCH_FEATURE_STATUS_PARAMETERS-Struktur gibt die Parameter für die benutzerdefinierten Statusinformationen eines Hyper-V erweiterbaren Schalters 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_FEATURE_STATUS_CUSTOM Struktur angegeben, die über eine OID-Methodenanforderung (Object Identifier) von OID_SWITCH_FEATURE_STATUS_QUERYzurückgegeben wird.

Syntax

typedef struct _NDIS_SWITCH_FEATURE_STATUS_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_FEATURE_STATUS_TYPE          FeatureStatusType;
  NDIS_SWITCH_OBJECT_ID                    FeatureStatusId;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           FeatureStatusInstanceId;
  NDIS_SWITCH_OBJECT_VERSION               FeatureStatusVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FeatureStatusBufferOffset;
  ULONG                                    FeatureStatusBufferLength;
} NDIS_SWITCH_FEATURE_STATUS_PARAMETERS, *PNDIS_SWITCH_FEATURE_STATUS_PARAMETERS;

Angehörige

Header

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

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie das Size Member auf NDIS_SIZEOF_NDIS_SWITCH_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.

FeatureStatusType

Ein NDIS_SWITCH_FEATURE_STATUS_TYPE Enumerationswert, der den Typ der Featurestatusinformationen für den erweiterbaren Switch angibt.

Hinweis Ab NDIS 6.30 muss dieses Element auf NdisSwitchFeatureStatusTypeCustomfestgelegt sein.

FeatureStatusId

Ein GUID-Wert, der die Featurestatusinformationen für den erweiterbaren Switch identifiziert.

Dieser Wert wird in der MOF-Klassendefinition (Managed Object Format) für die Featurestatusinformationen definiert. Weitere Informationen finden Sie unter Benutzerdefinierte Switch-Eigenschaftsdefinition und -registrierung.

FeatureStatusInstanceId

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

FeatureStatusVersion

Ein NDIS_SWITCH_OBJECT_VERSION Wert, der die Version der Featurestatusinformationen für den erweiterbaren Switch identifiziert. Dieser Wert wird in der MOF-Klassendefinition für die Featurestatusinformationen definiert.

SerializationVersion

Ein NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION Wert, der die Formatversion der serialisierten Statusinformationen für die Featurestatusinformationen identifiziert. Diese Daten werden für den Zugriff durch die Erweiterung aus der MOF-Datei 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.

FeatureStatusBufferOffset

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

Der Offset wird vom Anfang der NDIS_SWITCH_FEATURE_STATUS_PARAMETERS Struktur bis zum Anfang der NDIS_SWITCH_FEATURE_STATUS_CUSTOM Struktur gemessen.

FeatureStatusBufferLength

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

Bemerkungen

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

Eine NDIS_SWITCH_FEATURE_STATUS_PARAMETERS Struktur, die die Statusparameter für die Featurestatusinformationen des erweiterbaren Schalters angibt. 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_FEATURE_STATUS_CUSTOM Struktur, die die Featurestatusinformationen für den erweiterbaren Switch 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.