NDIS_SWITCH_FEATURE_STATUS_CUSTOM Struktur (ntddndis.h)

Artikel
02/07/2025

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

Syntax

typedef struct _NDIS_SWITCH_FEATURE_STATUS_CUSTOM {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              FeatureStatusCustomBufferLength;
  ULONG              FeatureStatusCustomBufferOffset;
} NDIS_SWITCH_FEATURE_STATUS_CUSTOM, *PNDIS_SWITCH_FEATURE_STATUS_CUSTOM;

Angehörige

Header

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

NDIS_SWITCH_FEATURE_STATUS_CUSTOM_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie den Size Member auf NDIS_SIZEOF_NDIS_SWITCH_FEATURE_STATUS_CUSTOM_REVISION_1 fest.

Flags

Ein ULONG-Wert, der ein bitweises ODER von Flags enthält. Dieses Mitglied ist für NDIS reserviert.

FeatureStatusCustomBufferLength

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

FeatureStatusCustomBufferOffset

Ein ULONG-Wert, der den Offset in Byte angibt, an den Featurestatuspuffer, der der NDIS_SWITCH_FEATURE_STATUS_CUSTOM Struktur folgt. Der Offset wird vom Anfang der NDIS_SWITCH_FEATURE_STATUS_CUSTOM Struktur bis zum Anfang des Featurestatuspuffers gemessen.

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 Parameter für die Featurestatusinformationen angibt, die für den erweiterbaren Switch 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_FEATURE_STATUS_CUSTOM Struktur, die die Featurestatusdaten 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.

Das InformationBuffer Member der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf diesen Informationspuffer.