NDIS_SWITCH_PROPERTY_CUSTOM Struktur (ntddndis.h)

Artikel
02/07/2025

Die NDIS_SWITCH_PROPERTY_CUSTOM struktur gibt eine benutzerdefinierte Profileigenschaft für den erweiterbaren Schalter Hyper-V an.

Unabhängige Softwareanbieter (ISVs) definieren das Format für die benutzerdefinierten Eigenschaften. Das Format der benutzerdefinierten Eigenschaft ist eigentum an den ISV.

Syntax

typedef struct _NDIS_SWITCH_PROPERTY_CUSTOM {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              PropertyBufferLength;
  ULONG              PropertyBufferOffset;
} NDIS_SWITCH_PROPERTY_CUSTOM, *PNDIS_SWITCH_PROPERTY_CUSTOM;

Angehörige

Header

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

NDIS_SWITCH_PROPERTY_CUSTOM_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie den Size Member auf NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_CUSTOM_REVISION_1 fest.

Flags

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

PropertyBufferLength

Ein ULONG-Wert, der die Größe des Puffers in Bytes angibt, der die benutzerdefinierte erweiterbare Switch-Eigenschaft enthält.

PropertyBufferOffset

Ein ULONG-Wert, der den Offset (in Byte) an den Eigenschaftenpuffer angibt. Der Offset wird vom Anfang der NDIS_SWITCH_PROPERTY_CUSTOM Struktur bis zum Anfang des Eigenschaftenpuffers gemessen.

Bemerkungen

Die NDIS_SWITCH_PROPERTY_CUSTOM Struktur wird in den folgenden OID-Setanforderungen verwendet:

Die NDIS_SWITCH_PROPERTY_CUSTOM Struktur folgt der NDIS_SWITCH_PROPERTY_PARAMETERS Struktur im Puffer, die diesen OID-Setanforderungen zugeordnet ist. Das InformationBuffer Member der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf diesen Puffer.

Erweiterbare Switcherweiterungen können mithilfe des NDIS_SWITCH_PROPERTY_CUSTOM_GET_BUFFER-Makros auf den benutzerdefinierten Erweiterbaren Switch-Eigenschaftenpuffer zugreifen, der durch eine NDIS_SWITCH_PROPERTY_CUSTOM Struktur angegeben wird.

Weitere Informationen zu erweiterbaren Switchrichtlinien finden Sie unter Hyper-V Extensible Switch Policies.