NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS結構（ntddndis.h）

發行項
02/07/2025

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 結構會指定 Hyper-V 可延伸交換器埠的原則屬性陣列。數位中的每個元素都會格式化為 NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO 結構。

語法

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;

成員

Header

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 結構的型別、修訂和大小。此成員的格式為 NDIS_OBJECT_HEADER 結構。

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

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_REVISION_1

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

將 Size 成員設定為 NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_REVISION_1。

Flags

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

PortId

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

PropertyType

指定埠屬性類型的 NDIS_SWITCH_PORT_PROPERTY_TYPE 列舉值。發出 OID_SWITCH_PORT_PROPERTY_ENUM 的 OID 方法要求時，可延伸交換器延伸模組會傳回符合此屬性類型的埠屬性。

PropertyId

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

SerializationVersion

識別串行化埠屬性數據格式版本的NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION值。此資料會串行化為從定義屬性之 Managed 物件格式（MOF）檔案的延伸模組進行存取。

Note For Windows Server 2012，SerializationVersion 成員必須設定為 NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1。

FirstPropertyOffset

USHORT 值，指定 NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 結構後面的第一個 NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO 元素位移，以位元組為單位。位移是從 NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 結構的開頭測量到陣列第一個專案的開頭。

Note 如果 NumProperties 的值為零，則會忽略此成員。

NumProperties

ULONG 值，指定 NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 結構後面的 NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO 項目數目。

Reserved

保留供日後使用。

言論

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 結構用於 OID_SWITCH_PORT_PROPERTY_ENUM的 OID 方法要求中。 NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO 結構的陣列會遵循與這些 OID 集合要求相關聯的信息緩衝區中的 NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 結構。 InformationBufferNDIS_OID_REQUEST 結構的成員包含這個資訊緩衝區的指標。

可延伸的交換器延伸模組可以使用 NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_GET_FIRST_INFO 巨集，存取由 NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 結構指定的第一個 NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO 結構。

如需可延伸交換器原則的詳細資訊，請參閱 Hyper-V 可延伸交換器原則。