NDIS_SWITCH_FEATURE_STATUS_PARAMETERS Struktur (ntddndis.h)

Die NDIS_SWITCH_FEATURE_STATUS_PARAMETERS Struktur gibt die Parameter für die benutzerdefinierten Statusinformationen eines erweiterbaren Hyper-V-Schalters an. Diese Informationen werden als Featurestatusinformationen 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_QUERY zurü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;

Member

Header

Der Typ, die Überarbeitung und die Größe der NDIS_SWITCH_FEATURE_STATUS_PARAMETERS Struktur. Dieses Element wird als NDIS_OBJECT_HEADER Struktur formatiert.

Das Element "Typ " der Kopfzeile muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden. Um die Version der NDIS_SWITCH_FEATURE_STATUS_PARAMETERS Struktur anzugeben, muss das Revisionselement der Kopfzeile 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 Element "Größe " auf NDIS_SIZEOF_NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1 fest.

Flags

Ein ULONG-Wert, der ein bitweises OR 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 NdisSwitchFeatureStatusTypeCustom festgelegt werden.
 

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 Funktionsstatusinformationen 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-Element auf NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1 festgelegt werden.
 

FeatureStatusBufferOffset

Ein ULONG-Wert, der den Offset in Bytes angibt, an den Featurestatuspuffer, der der 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_QUERY verwendet. Diese OID-Anforderung gibt die folgenden Strukturen im Informationspuffer zurück, der der OID-Anforderung zugeordnet ist:

  • Eine NDIS_SWITCH_FEATURE_STATUS_PARAMETERS Struktur, die die Statusparameter für die Featurestatusinformationen des erweiterbaren Schalters angibt. Die Switcherweiterung füllt das FeatureStatusVersion-Element 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 Switch füllt alle anderen Member beim Ausgeben des Abfrage-OID auf.
  • Eine NDIS_SWITCH_FEATURE_STATUS_CUSTOM Struktur, die die Funktionsstatusinformationen für den erweiterbaren Switch enthält. Die Switcherweiterung füllt das FeatureStatusCustomBufferLength-Element der Struktur auf, um die Größe des zurückgegebenen benutzerdefinierten Status widerzuspiegeln. Der Hyper-v Extensible Switch füllt alle anderen Member beim Ausgeben des Abfrage-OID auf.

Anforderungen

   
Unterstützte Mindestversion (Client) Unterstützt in NDIS 6.30 und höher.
Header ntddndis.h (include Ndis.h)

Weitere Informationen

NDIS_OBJECT_HEADER

NDIS_SWITCH_FEATURE_STATUS_CUSTOM

NDIS_SWITCH_FEATURE_STATUS_TYPE

OID_SWITCH_FEATURE_STATUS_QUERY