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.
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;
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:
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".
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.
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.
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.
Weitere Informationen zu erweiterbaren Switchrichtlinien finden Sie unter Hyper-V Extensible Switch Policies.
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Unterstützt in NDIS 6.30 und höher. |
Header- | ntddndis.h (include Ndis.h, Fwpsk.h) |
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