NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS 結構 (ntddndis.h)

發行項
02/26/2024

NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS 結構會指定 Hyper-V 可延伸交換器埠之自定義狀態資訊的參數。這項資訊稱為 功能狀態 資訊。此資訊的格式是由獨立軟體廠商所定義， (ISV) 。

狀態資訊是透過 NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM 結構指定，並透過 OID_SWITCH_PORT_FEATURE_STATUS_QUERY的 OID 方法要求傳回。

語法

typedef struct _NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_FEATURE_STATUS_TYPE     FeatureStatusType;
  NDIS_SWITCH_OBJECT_ID                    FeatureStatusId;
  NDIS_SWITCH_OBJECT_VERSION               FeatureStatusVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           FeatureStatusInstanceId;
  ULONG                                    FeatureStatusBufferLength;
  ULONG                                    FeatureStatusBufferOffset;
  ULONG                                    Reserved;
} NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS, *PNDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS;

成員

Header

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

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

NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS_REVISION_1

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

將 Size 成員設定為 NDIS_SIZEOF_NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS_REVISION_1。

Flags

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

PortId

NDIS_SWITCH_PORT_ID值，指定可延伸交換器埠的數值標識符。這個值可唯一識別要傳回功能狀態資訊的可延伸交換器上的埠。

FeatureStatusType

NDIS_SWITCH_PORT_FEATURE_STATUS_TYPE列舉值，指定自定義可延伸交換器埠配置檔屬性的狀態信息類型。

注意從 NDIS 6.30 開始，此成員必須設定為 NdisSwitchPortPropertyTypeCustom。

FeatureStatusId

識別可延伸交換器埠之配置檔屬性的NDIS_SWITCH_OBJECT_ID值。

FeatureStatusVersion

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

SerializationVersion

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

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

FeatureStatusInstanceId

NDIS_SWITCH_OBJECT_INSTANCE_ID值，識別可延伸交換器埠的功能狀態信息實例。

FeatureStatusBufferLength

ULONG 值，指定功能狀態緩衝區的大小，以位元組為單位。

FeatureStatusBufferOffset

ULONG 值，指定 NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS結構後面的 功能狀態緩衝區位移，以位元組為單位。功能狀態緩衝區包含 NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM 結構。

位移是從 NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS 結構的開頭到 NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM 結構的開頭來測量。

Reserved

保留供未來使用。

備註

NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS結構用於 OID_SWITCH_PORT_FEATURE_STATUS_QUERY 的 OID 方法要求中。此 OID 要求會在與 OID 要求相關聯的資訊緩衝區中傳回下列結構：

NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS 結構，指定要傳回狀態資訊之可延伸交換器埠之自定義屬性的參數。參數延伸模組會填入結構的 FeatureStatusVersion 成員，以反映NDIS_SWITCH_FEATURE_STATUS_CUSTOM緩衝區中傳回的自定義狀態版本。發出查詢 OID 時，Hyper-v Extensible 參數會填入所有其他成員。
NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM 結構，其中包含可延伸交換器埠屬性的狀態資訊。參數延伸模組會填入結構的 FeatureStatusCustomBufferLength 成員，以反映所傳回之自定義狀態的大小。發出查詢 OID 時，Hyper-v Extensible 參數會填入所有其他成員。