NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS-Struktur (ntddndis.h)

Artikel
08/07/2023

Die NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS-Struktur gibt ein Array von Richtlinieneigenschaften für einen erweiterbaren Hyper-V-Switchport an. Jedes Element im Array ist als NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO-Struktur formatiert.

Syntax

typedef struct _NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_PROPERTY_TYPE           PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FirstPropertyOffset;
  ULONG                                    NumProperties;
  USHORT                                   Reserved;
} NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS;

Member

Header

Typ, Revision und Größe der NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS-Struktur . Dieser Member 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_ENUM_PARAMETERS-Struktur anzugeben, muss der Revisionsmember von Header auf den folgenden Wert festgelegt werden:

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_REVISION_1

Originalversion für NDIS 6.30 und höher.

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

Flags

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

PortId

Ein NDIS_SWITCH_PORT_ID Wert, der den eindeutigen Bezeichner des erweiterbaren Switchports enthält, für den Eigenschaften aufgezählt werden.

PropertyType

Ein NDIS_SWITCH_PORT_PROPERTY_TYPE Enumerationswert, der den Porteigenschaftentyp angibt. Wenn eine OID-Methodenanforderung von OID_SWITCH_PORT_PROPERTY_ENUM ausgegeben wird, gibt die erweiterbare Switcherweiterung Porteigenschaften zurück, die mit diesem Eigenschaftentyp übereinstimmen.

PropertyId

Ein GUID-Wert, der die Eigenschaft für den erweiterbaren Switchport identifiziert.

SerializationVersion

Ein NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION Wert, der die Formatversion der daten der serialisierten Porteigenschaft 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.

FirstPropertyOffset

Ein USHORT-Wert, der den Offset in Bytes für das erste NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO Element angibt, das der NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS-Struktur folgt. Der Offset wird vom Anfang der NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS-Struktur bis zum Anfang des ersten Elements des Arrays gemessen.

Hinweis Wenn der Wert von NumProperties null ist, wird dieser Member ignoriert.

NumProperties

Ein ULONG-Wert, der die Anzahl der NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO-Elemente angibt, die der NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS-Struktur folgen.

Reserved

Für die zukünftige Verwendung reserviert.

Bemerkungen

Die NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS-Struktur wird in OID-Methodenanforderungen von OID_SWITCH_PORT_PROPERTY_ENUM verwendet. Ein Array von NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO Strukturen folgt der NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS-Struktur im Informationspuffer, der diesen OID-Mengenanforderungen zugeordnet ist. Der InformationBuffer-Member der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf diesen Informationspuffer.

Erweiterbare Switcherweiterungen können mithilfe des makros NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_GET_FIRST_INFO auf die erste NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO-Struktur zugreifen, die von der NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS-Struktur angegeben wird.

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