NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM-Struktur (ntddndis.h)

Artikel
03/01/2024

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

Syntax

typedef struct _NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              FeatureStatusBufferLength;
  ULONG              FeatureStatusBufferOffset;
} NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM, *PNDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM;

Member

Header

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

NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM_REVISION_1

Ursprüngliche Version für NDIS 6.30 und höher.

Legen Sie das Element Größe auf NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM_REVISION_1 fest.

Flags

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

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_CUSTOM-Struktur folgt. Der Offset wird vom Beginn der NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM-Struktur bis zum Anfang des Features status Puffers gemessen.

Hinweise

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 das Feature angibt, status Informationen angibt, die für einen erweiterbaren Switchport 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 das Feature status Daten für den angegebenen erweiterbaren Switchport 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.

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