NDIS_SWITCH_PROPERTY_PARAMETERS結構（ntddndis.h）

發行項
02/07/2025

NDIS_SWITCH_PROPERTY_PARAMETERS 結構會指定 Hyper-V 可延伸參數之原則屬性的參數。

語法

typedef struct _NDIS_SWITCH_PROPERTY_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_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;
} NDIS_SWITCH_PROPERTY_PARAMETERS, *PNDIS_SWITCH_PROPERTY_PARAMETERS;

成員

Header

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

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

NDIS_SWITCH_PROPERTY_PARAMETERS_REVISION_1

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

將 Size 成員設定為 NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_PARAMETERS_REVISION_1。

Flags

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

PropertyType

NDIS_SWITCH_PROPERTY_TYPE 列舉值，指定屬性緩衝區中包含的可延伸參數屬性類型。

PropertyId

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

如需詳細資訊，請參閱一節。

Note 除非 PropertyType 成員設定為 NdisSwitchPropertyTypeCustom，否則可延伸參數延伸模組必須忽略此成員。

PropertyVersion

識別可延伸參數屬性版本的NDIS_SWITCH_OBJECT_VERSION值。

SerializationVersion

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

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

PropertyInstanceId

NDIS_SWITCH_OBJECT_INSTANCE_ID值，指定可延伸交換器屬性的實例標識碼。

PropertyBufferLength

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

PropertyBufferOffset

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

言論

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

屬性緩衝區包含與 propertyType 成員相關聯的結構。屬性緩衝區會遵循與這些 OID 集合要求相關聯的信息緩衝區中 NDIS_SWITCH_PROPERTY_PARAMETERS 結構。 InformationBufferNDIS_OID_REQUEST 結構的成員包含這個資訊緩衝區的指標。

Note 從 Windows Server 2012 開始，PropertyType 成員必須設定為 NdisSwitchPropertyTypeCustom，而且屬性緩衝區必須包含 NDIS_SWITCH_PROPERTY_CUSTOM 結構。

可延伸參數延伸模組可以使用 NDIS_SWITCH_PROPERTY_PARAMETERS_GET_PROPERTY 巨集，存取 NDIS_SWITCH_PROPERTY_PARAMETERS 結構內的可延伸交換器屬性緩衝區。

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