NDIS_SWITCH_PROPERTY_PARAMETERS-Struktur (ntddndis.h)

Artikel
08/07/2023

Die NDIS_SWITCH_PROPERTY_PARAMETERS-Struktur gibt die Parameter für eine Richtlinieneigenschaft eines erweiterbaren Hyper-V-Switches an.

Syntax

typedef struct _NDIS_SWITCH_PROPERTY_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PROPERTY_TYPE                PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_VERSION               PropertyVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           PropertyInstanceId;
  ULONG                                    PropertyBufferLength;
  ULONG                                    PropertyBufferOffset;
} NDIS_SWITCH_PROPERTY_PARAMETERS, *PNDIS_SWITCH_PROPERTY_PARAMETERS;

Member

Header

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

NDIS_SWITCH_PROPERTY_PARAMETERS_REVISION_1

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

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

Flags

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

PropertyType

Ein NDIS_SWITCH_PROPERTY_TYPE Enumerationswert, der den Typ der erweiterbaren Switcheigenschaft angibt, die im Eigenschaftenpuffer enthalten ist.

PropertyId

Ein GUID-Wert, der die erweiterbare Switcheigenschaft identifiziert.

Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

Hinweis Die erweiterbare Switcherweiterung muss diesen Member ignorieren, es sei denn, das PropertyType-Element ist auf NdisSwitchPropertyTypeCustom festgelegt.

PropertyVersion

Ein NDIS_SWITCH_OBJECT_VERSION Wert, der die Version der erweiterbaren Switch-Eigenschaft angibt.

SerializationVersion

Ein NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION Wert, der die Formatversion der serialisierten erweiterbaren Switcheigenschaftendaten angibt. Diese Daten werden für den Zugriff durch die Erweiterung aus der MOF-Datei (Managed Object Format) 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.

PropertyInstanceId

Ein NDIS_SWITCH_OBJECT_INSTANCE_ID Wert, der den instance Bezeichner der erweiterbaren Switcheigenschaft angibt.

PropertyBufferLength

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

PropertyBufferOffset

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

Hinweise

Die NDIS_SWITCH_PROPERTY_PARAMETERS-Struktur wird in den folgenden OID-Satzanforderungen verwendet:

Der Eigenschaftenpuffer enthält eine Struktur, die dem PropertyType-Element zugeordnet ist. Der Eigenschaftenpuffer folgt der NDIS_SWITCH_PROPERTY_PARAMETERS-Struktur im Informationspuffer, der diesen OID-Setanforderungen zugeordnet ist. Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf diesen Informationspuffer.

Hinweis Ab Windows Server 2012 muss das PropertyType-Element auf NdisSwitchPropertyTypeCustom festgelegt werden, und der Eigenschaftenpuffer muss eine NDIS_SWITCH_PROPERTY_CUSTOM-Struktur enthalten.

Erweiterbare Switcherweiterungen können mithilfe des makros NDIS_SWITCH_PROPERTY_PARAMETERS_GET_PROPERTY auf den erweiterbaren Switcheigenschaftenpuffer in einer NDIS_SWITCH_PROPERTY_PARAMETERS-Struktur zugreifen.

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