NDIS_SWITCH_PORT_PROPERTY_CUSTOM-Struktur (ntddndis.h)

Artikel
02/26/2024

Die NDIS_SWITCH_PORT_PROPERTY_CUSTOM-Struktur gibt eine benutzerdefinierte Richtlinieneigenschaft für einen erweiterbaren Hyper-V-Switchport an.

Unabhängige Softwareanbieter (Independent Software Vendors, ISVs) definieren das Format für die benutzerdefinierten Eigenschaften. Das Format der benutzerdefinierten Eigenschaft ist für den ISV geschützt.

Syntax

typedef struct _NDIS_SWITCH_PORT_PROPERTY_CUSTOM {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              PropertyBufferLength;
  ULONG              PropertyBufferOffset;
} NDIS_SWITCH_PORT_PROPERTY_CUSTOM, *PNDIS_SWITCH_PORT_PROPERTY_CUSTOM;

Member

Header

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

NDIS_SWITCH_PORT_PROPERTY_CUSTOM_REVISION_1

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

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

Flags

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

PropertyBufferLength

Ein ULONG-Wert, der die Größe des Puffers angibt, der die benutzerdefinierte Porteigenschaft enthält.

PropertyBufferOffset

Ein ULONG-Wert, der den Offset in Bytes für den Eigenschaftenpuffer angibt. Der Offset wird vom Beginn der NDIS_SWITCH_PORT_PROPERTY_CUSTOM-Struktur bis zum Anfang des Eigenschaftspuffers gemessen.

Hinweise

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

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

Erweiterbare Switcherweiterungen können mithilfe des makros NDIS_SWITCH_PORT_PROPERTY_CUSTOM_GET_BUFFER auf den Puffer der benutzerdefinierten Porteigenschaften in einer NDIS_SWITCH_PORT_PROPERTY_CUSTOM-Struktur zugreifen.

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