Auf Englisch lesen

Freigeben über


NDIS_SWITCH_PORT_PROPERTY_PARAMETERS Struktur (ntddndis.h)

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

Syntax

typedef struct _NDIS_SWITCH_PORT_PROPERTY_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_VERSION               PropertyVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           PropertyInstanceId;
  ULONG                                    PropertyBufferLength;
  ULONG                                    PropertyBufferOffset;
  ULONG                                    Reserved;
} NDIS_SWITCH_PORT_PROPERTY_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_PARAMETERS;

Angehörige

Header

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

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie den Size Member auf NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1 fest.

Flags

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

PortId

Ein NDIS_SWITCH_PORT_ID Wert, der den eindeutigen Bezeichner des erweiterbaren Switchports enthält, dem die Eigenschaft zugewiesen ist.

PropertyType

Ein NDIS_SWITCH_PORT_PROPERTY_TYPE Enumerationswert, der den Typ der Porteigenschaft angibt, die im Eigenschaftenpuffer enthalten ist.

PropertyId

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

Weitere Informationen finden Sie im Abschnitt "Hinweise".

Hinweis Die erweiterbare Switcherweiterung muss dieses Element ignorieren, es sei denn, der PropertyType Member ist auf NdisSwitchPortPropertyTypeCustomfestgelegt.
 

PropertyVersion

Ein NDIS_SWITCH_OBJECT_VERSION Wert, der die Version der Eigenschaft für den erweiterbaren Switchport identifiziert.

SerializationVersion

Ein NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION Wert, der die Formatversion der serialisierten Porteigenschaftendaten identifiziert. 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-Mitglied auf NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1 festgelegt sein.
 

PropertyInstanceId

Ein NDIS_SWITCH_OBJECT_INSTANCE_ID Wert, der die Instanz der Eigenschaft für den erweiterbaren Switchport identifiziert.

PropertyBufferLength

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

PropertyBufferOffset

Ein ULONG-Wert, der den Offset in Byte angibt, an den Eigenschaftenpuffer, der auf die NDIS_SWITCH_PORT_PROPERTY_PARAMETERS Struktur folgt. Der Offset wird vom Anfang der NDIS_SWITCH_PORT_PROPERTY_PARAMETERS Struktur bis zum Anfang des Eigenschaftenpuffers gemessen.

Reserved

Reserviert für die zukünftige Verwendung.

Bemerkungen

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

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

Die erweiterbare Switcherweiterung muss die folgenden Richtlinien befolgen, wenn sie eine NDIS_SWITCH_PORT_PROPERTY_PARAMETERS Struktur verarbeitet:

  • Wenn der PropertyType Member auf NdisSwitchPortPropertyTypeSecurityfestgelegt ist, wird der Eigenschaftenpuffer als NDIS_SWITCH_PORT_PROPERTY_SECURITY Struktur formatiert.
  • Wenn der PropertyType Member auf NdisSwitchPortPropertyTypeVlanfestgelegt ist, wird der Eigenschaftenpuffer als NDIS_SWITCH_PORT_PROPERTY_VLAN Struktur formatiert.
  • Wenn der PropertyType Member auf NdisSwitchPortPropertyTypeProfilefestgelegt ist, wird der Eigenschaftenpuffer als NDIS_SWITCH_PORT_PROPERTY_PROFILE Struktur formatiert.
  • Wenn der PropertyType Member auf NdisSwitchPortPropertyTypeCustomfestgelegt ist, muss das PropertyId-element auf den GUID-Wert festgelegt werden, den der unabhängige Softwareanbieter (ISV) für die benutzerdefinierte Porteigenschaft erstellt hat. Der Eigenschaftenpuffer ist als NDIS_SWITCH_PORT_PROPERTY_CUSTOM Struktur formatiert, die die Parameter für die benutzerdefinierte Porteigenschaft enthält, wie von der ISV definiert.
Erweiterbare Switcherweiterungen können mithilfe des NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_GET_PROPERTY-Makros auf die benutzerdefinierte Porteigenschaft innerhalb einer NDIS_SWITCH_PORT_PROPERTY_PARAMETERS Struktur zugreifen.

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

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Unterstützt in NDIS 6.30 und höher.
Header- ntddndis.h (include Ndis.h, Fwpsk.h)

Siehe auch

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PROPERTY_CUSTOM

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_GET_PROPERTY

NDIS_SWITCH_PORT_PROPERTY_PROFILE

NDIS_SWITCH_PORT_PROPERTY_SECURITY

NDIS_SWITCH_PORT_PROPERTY_TYPE

NDIS_SWITCH_PORT_PROPERTY_VLAN

OID_SWITCH_PORT_PROPERTY_ADD

OID_SWITCH_PORT_PROPERTY_UPDATE