共用方式為

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS結構 （ntddndis.h）

  • 發行項

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 結構會指定 Hyper-V 可延伸參數之自定義狀態信息的參數。 這項信息稱為 功能狀態 資訊。 此資訊的格式是由獨立軟體廠商 （ISV） 所定義。

狀態資訊是透過 NDIS_SWITCH_FEATURE_STATUS_CUSTOM 結構來指定，該結構是透過 OID_SWITCH_FEATURE_STATUS_QUERY的物件識別碼 （OID） 方法要求傳回。

語法

typedef struct _NDIS_SWITCH_FEATURE_STATUS_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_FEATURE_STATUS_TYPE          FeatureStatusType;
  NDIS_SWITCH_OBJECT_ID                    FeatureStatusId;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           FeatureStatusInstanceId;
  NDIS_SWITCH_OBJECT_VERSION               FeatureStatusVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FeatureStatusBufferOffset;
  ULONG                                    FeatureStatusBufferLength;
} NDIS_SWITCH_FEATURE_STATUS_PARAMETERS, *PNDIS_SWITCH_FEATURE_STATUS_PARAMETERS;

成員

Header

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

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

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1

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

將 Size 成員設定為 NDIS_SIZEOF_NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1。

Flags

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

FeatureStatusType

NDIS_SWITCH_FEATURE_STATUS_TYPE 列舉值，指定可延伸參數的功能狀態信息類型。

注意 從 NDIS 6.30 開始，這個成員必須設定為 NdisSwitchFeatureStatusTypeCustom。
 

FeatureStatusId

GUID 值，識別可延伸交換器的功能狀態資訊。

此值是以 Managed 物件格式 （MOF） 類別定義來定義功能狀態資訊。 如需詳細資訊，請參閱 自訂交換器屬性定義和註冊。

FeatureStatusInstanceId

NDIS_SWITCH_OBJECT_INSTANCE_ID值，識別可延伸參數的功能狀態信息實例。

FeatureStatusVersion

NDIS_SWITCH_OBJECT_VERSION值，識別可延伸參數的功能狀態資訊版本。 此值定義於功能狀態資訊的MOF類別定義中。

SerializationVersion

NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION值，識別功能狀態資訊之串行化狀態資訊的格式版本。 此數據會串行化為從定義 屬性之MOF檔案的延伸模組進行存取。

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

FeatureStatusBufferOffset

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

位移是從 NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 結構的開頭到 NDIS_SWITCH_FEATURE_STATUS_CUSTOM 結構的開頭來測量。

FeatureStatusBufferLength

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

言論

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

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

要求

要求 價值
最低支援的用戶端 NDIS 6.30 和更新版本支援。
標頭 ntddndis.h （包括 Ndis.h）

另請參閱

NDIS_OBJECT_HEADER

NDIS_SWITCH_FEATURE_STATUS_CUSTOM

NDIS_SWITCH_FEATURE_STATUS_TYPE

OID_SWITCH_FEATURE_STATUS_QUERY