NDIS_SWITCH_FEATURE_STATUS_CUSTOM 結構 (ntddndis.h)

發行項
02/26/2024

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

語法

typedef struct _NDIS_SWITCH_FEATURE_STATUS_CUSTOM {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              FeatureStatusCustomBufferLength;
  ULONG              FeatureStatusCustomBufferOffset;
} NDIS_SWITCH_FEATURE_STATUS_CUSTOM, *PNDIS_SWITCH_FEATURE_STATUS_CUSTOM;

成員

Header

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

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

NDIS_SWITCH_FEATURE_STATUS_CUSTOM_REVISION_1

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

將 Size 成員設定為 NDIS_SIZEOF_NDIS_SWITCH_FEATURE_STATUS_CUSTOM_REVISION_1。

Flags

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

FeatureStatusCustomBufferLength

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

FeatureStatusCustomBufferOffset

ULONG 值，指定 NDIS_SWITCH_FEATURE_STATUS_CUSTOM結構後面的 功能狀態緩衝區的位移，以位元組為單位。位移是從 NDIS_SWITCH_FEATURE_STATUS_CUSTOM 結構的開頭測量到功能狀態緩衝區的開頭。

備註

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_OID_REQUEST 結構的 InformationBuffer 成員包含此資訊緩衝區的指標。