NDIS_SWITCH_PORT_PROPERTY_PARAMETERS-Struktur (ntddndis.h)
Die NDIS_SWITCH_PORT_PROPERTY_PARAMETERS-Struktur gibt die Parameter für eine Richtlinieneigenschaft eines erweiterbaren Hyper-V-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;
Member
Header
Der Typ, die Revision und die Größe der NDIS_SWITCH_PORT_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_PORT_PROPERTY_PARAMETERS-Struktur anzugeben, muss der Revisionsmember von Header auf den folgenden Wert festgelegt werden:
NDIS_SWITCH_PORT_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_PORT_PROPERTY_PARAMETERS_REVISION_1 fest.
Flags
Ein ULONG-Wert, der ein bitweises OR von Flags enthält. Dieses Element 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 mit Hinweisen.
PropertyVersion
Ein NDIS_SWITCH_OBJECT_VERSION Wert, der die Version der Eigenschaft für den erweiterbaren Switchport angibt.
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.
PropertyInstanceId
Ein NDIS_SWITCH_OBJECT_INSTANCE_ID Wert, der die instance der Eigenschaft für den erweiterbaren Switchport identifiziert.
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_PORT_PROPERTY_PARAMETERS-Struktur folgt. Der Offset wird vom Anfang der NDIS_SWITCH_PORT_PROPERTY_PARAMETERS-Struktur bis zum Anfang des Eigenschaftspuffers gemessen.
Reserved
Für die zukünftige Verwendung reserviert.
Bemerkungen
Die NDIS_SWITCH_PORT_PROPERTY_PARAMETERS-Struktur wird in den folgenden OID-Satzanforderungen verwendet:
Der Eigenschaftenpuffer enthält eine Struktur, die dem PropertyType-Element zugeordnet ist. Der Eigenschaftspuffer folgt der NDIS_SWITCH_PORT_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.Die erweiterbare Switcherweiterung muss die folgenden Richtlinien befolgen, wenn sie eine NDIS_SWITCH_PORT_PROPERTY_PARAMETERS-Struktur verarbeitet:
- Wenn das PropertyType-Element auf NdisSwitchPortPropertyTypeSecurity festgelegt ist, wird der Eigenschaftenpuffer als NDIS_SWITCH_PORT_PROPERTY_SECURITY-Struktur formatiert.
- Wenn das PropertyType-Element auf NdisSwitchPortPropertyTypeVlan festgelegt ist, wird der Eigenschaftenpuffer als NDIS_SWITCH_PORT_PROPERTY_VLAN-Struktur formatiert.
- Wenn das PropertyType-Element auf NdisSwitchPortPropertyTypeProfile festgelegt ist, wird der Eigenschaftenpuffer als NDIS_SWITCH_PORT_PROPERTY_PROFILE-Struktur formatiert.
- Wenn das PropertyType-Element auf NdisSwitchPortPropertyTypeCustom festgelegt ist, muss das PropertyId-Element auf den GUID-Wert festgelegt werden, den der unabhängige Softwareanbieter (Independent Software Vendor, 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 vom ISV definierte benutzerdefinierte Porteigenschaft enthält.
Weitere Informationen zu erweiterbaren Switchrichtlinien finden Sie unter Hyper-V Extensible Switch Policies.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Unterstützt in NDIS 6.30 und höher. |
Kopfzeile | ntddndis.h (include Ndis.h, Fwpsk.h) |
Weitere Informationen
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