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構造体のバージョンを指定するには、Header の Revision メンバーを次の値に設定する必要があります。

NDIS_SWITCH_FEATURE_STATUS_CUSTOM_REVISION_1

NDIS 6.30 以降の元のバージョン。

[サイズ] メンバーを [NDIS_SIZEOF_NDIS_SWITCH_FEATURE_STATUS_CUSTOM_REVISION_1] に設定します。

Flags

フラグのビットごとの OR を含む ULONG 値。このメンバーは NDIS 用に予約されています。

FeatureStatusCustomBufferLength

機能状態バッファーのサイズをバイト単位で指定する ULONG 値。

FeatureStatusCustomBufferOffset

NDIS_SWITCH_FEATURE_STATUS_CUSTOM構造体に続く機能状態バッファーへのオフセットをバイト単位で指定する ULONG 値。オフセットは、 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 バッファーで返されるカスタム状態のバージョンを反映するように設定します。 Hyper-v 拡張可能スイッチは、クエリ OID の発行時に他のすべてのメンバーを設定します。
拡張可能スイッチの機能状態データを含む NDIS_SWITCH_FEATURE_STATUS_CUSTOM 構造体。スイッチ拡張機能は、返されるカスタム状態のサイズを反映するために、構造体の FeatureStatusCustomBufferLength メンバーを設定します。 Hyper-v 拡張可能スイッチは、クエリ OID の発行時に他のすべてのメンバーを設定します。

NDIS_OID_REQUEST構造体の InformationBuffer メンバーには、この情報バッファーへのポインターが含まれています。