NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 結構 (ntddndis.h)

發行項
08/07/2023

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 結構會指定 Hyper-V 可延伸交換器埠之原則屬性的參數。

語法

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

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 結構的型別、修訂和大小。這個成員會格式化為 NDIS_OBJECT_HEADER 結構。

Header 的 Type 成員必須設定為 NDIS_OBJECT_TYPE_DEFAULT。若要指定NDIS_SWITCH_PORT_PROPERTY_PARAMETERS結構的版本，標頭的 Revision 成員必須設定為下列值：

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1

NDIS 6.30 和更新版本的原始版本。

將 Size 成員設定為 NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1。

Flags

包含旗標位 OR 的 ULONG 值。此成員保留給 NDIS。

PortId

NDIS_SWITCH_PORT_ID值，其中包含指派屬性之可延伸交換器埠的唯一標識符。

PropertyType

NDIS_SWITCH_PORT_PROPERTY_TYPE列舉值，指定包含在屬性緩衝區中的埠屬性類型。

PropertyId

GUID 值，識別可延伸交換器埠的屬性。

如需詳細資訊，請參閱＜備註＞一節。

注意除非 PropertyType 成員設定為 NdisSwitchPortPropertyTypeCustom，否則可延伸交換器延伸模組必須忽略這個成員。

PropertyVersion

識別可延伸交換器埠之屬性版本的NDIS_SWITCH_OBJECT_VERSION值。

SerializationVersion

識別串行化埠屬性數據格式版本的NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION值。此數據會串行化為從 Managed 物件格式 (MOF) 定義屬性的檔案存取。

注意對於 Windows Server 2012，SerializationVersion 成員必須設定為 NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1。

PropertyInstanceId

識別可延伸交換器埠之屬性實例的NDIS_SWITCH_OBJECT_INSTANCE_ID值。

PropertyBufferLength

ULONG 值，指定屬性緩衝區的大小，以位元組為單位。

PropertyBufferOffset

ULONG 值，指定位移，以位元組為單位，指向 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 結構後面的屬性緩衝區。位移是從 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 結構的開頭到屬性緩衝區的開頭進行測量。

Reserved

保留供未來使用。

備註

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS結構用於下列 OID 集合要求：

屬性緩衝區包含與 PropertyType 成員相關聯的結構。屬性緩衝區會遵循與這些 OID 集合要求相關聯的信息緩衝區中 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 結構。 NDIS_OID_REQUEST 結構的 InformationBuffer 成員包含此資訊緩衝區的指標。

當可延伸交換器擴充功能處理 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 結構時，必須遵循這些指導方針：

如果 PropertyType 成員設定為 NdisSwitchPortPropertyTypeSecurity，屬性緩衝區會格式化為 NDIS_SWITCH_PORT_PROPERTY_SECURITY 結構。
如果 PropertyType 成員設定為 NdisSwitchPortPropertyTypeVlan，屬性緩衝區會格式化為 NDIS_SWITCH_PORT_PROPERTY_VLAN 結構。
如果 PropertyType 成員設定為 NdisSwitchPortPropertyTypeProfile，屬性緩衝區會格式化為 NDIS_SWITCH_PORT_PROPERTY_PROFILE 結構。
如果 PropertyType 成員設定為 NdisSwitchPortPropertyTypeCustom， 則 PropertyId 成員必須設定為獨立軟體廠商 (ISV) 為自定義埠屬性建立的獨立軟體廠商 GUID 值。屬性緩衝區會格式化為 NDIS_SWITCH_PORT_PROPERTY_CUSTOM 結構，其中包含ISV所定義的自定義埠屬性參數。