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 結構。

HeaderType成員必須設定為 NDIS_OBJECT_TYPE_DEFAULT。 若要指定NDIS_SWITCH_FEATURE_STATUS_PARAMETERS結構的版本,標頭Revision成員必須設定為下列值:

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1

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

Size 成員設定為 NDIS_SIZEOF_NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1。

Flags

包含旗標位 OR 的 ULONG 值。 此成員會保留給 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 檔案進行延伸模組的存取。

注意針對 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 可延伸交換器會填入所有其他成員。
  • 包含可延伸參數之功能狀態資訊的 NDIS_SWITCH_FEATURE_STATUS_CUSTOM 結構。 參數延伸模組會填入結構的 FeatureStatusCustomBufferLength 成員,以反映所傳回之自訂狀態的大小。 發出查詢 OID 時,Hyper-v 可延伸交換器會填入所有其他成員。

必要條件

   
最低支援的用戶端 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