NDIS_SWITCH_PROPERTY_ENUM_INFO結構 (ntddndis.h)

發行項
03/05/2024

NDIS_SWITCH_PROPERTY_ENUM_INFO 結構會指定 Hyper-V 可延伸交換器之配置檔屬性的相關信息。

語法

typedef struct _NDIS_SWITCH_PROPERTY_ENUM_INFO {
  NDIS_OBJECT_HEADER             Header;
  ULONG                          Flags;
  NDIS_SWITCH_OBJECT_INSTANCE_ID PropertyInstanceId;
  NDIS_SWITCH_OBJECT_VERSION     PropertyVersion;
  ULONG                          QwordAlignedPropertyBufferLength;
  ULONG                          PropertyBufferLength;
  ULONG                          PropertyBufferOffset;
} NDIS_SWITCH_PROPERTY_ENUM_INFO, *PNDIS_SWITCH_PROPERTY_ENUM_INFO;

成員

Header

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

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

NDIS_SWITCH_PROPERTY_ENUM_INFO_REVISION_1

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

將 Size 成員設定為 NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1。

Flags

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

PropertyInstanceId

NDIS_SWITCH_OBJECT_INSTANCE_ID值，指定可延伸參數屬性的實例標識符。

PropertyVersion

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

QwordAlignedPropertyBufferLength

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

PropertyBufferLength

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

注意這個值必須小於或等於 QwordAlignedPropertyBufferLength 成員的值。

PropertyBufferOffset

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

備註

NDIS_SWITCH_PROPERTY_ENUM_INFO結構用於OID_SWITCH_PROPERTY_ENUM的 OID 集合要求中。 NDIS_SWITCH_PROPERTY_ENUM_INFO 結構的陣列會遵循與這些 OID 集合要求相關聯的信息緩衝區中的NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS結構。 NDIS_OID_REQUEST 結構的 InformationBuffer 成員包含此資訊緩衝區的指標。

可延伸參數延伸模組可以使用 NDIS_SWITCH_PROPERTY_ENUM_INFO_GET_NEXT 宏，存取陣列中NDIS_SWITCH_PROPERTY_ENUM_INFO結構後面的下一個NDIS_SWITCH_PROPERTY_ENUM_INFO元素。

可延伸交換器延伸模組可以使用 NDIS_SWITCH_PROPERTY_ENUM_INFO_GET_PROPERTY 宏，存取由NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO結構所指定的可延伸交換器屬性緩衝區。

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