PEP_QUERY_COMPONENT_PERF_SET_NAME 構造体 (pepfx.h)

[アーティクル]
03/05/2024

PEP_QUERY_COMPONENT_PERF_SET_NAME構造体には、コンポーネントの一連のパフォーマンス状態値 (P 状態セット) に関するクエリ情報が含まれています。

構文

typedef struct _PEP_QUERY_COMPONENT_PERF_SET_NAME {
  [in]      PEPHANDLE DeviceHandle;
  [in]      ULONG     Component;
  [in]      ULONG     Set;
  [in, out] USHORT    NameSize;
  [in]      PWCHAR    Name;
} PEP_QUERY_COMPONENT_PERF_SET_NAME, *PPEP_QUERY_COMPONENT_PERF_SET_NAME;

メンバー

[in] DeviceHandle

デバイスを識別する PEPHANDLE 値。 PEP は、以前のPEP_DPM_REGISTER_DEVICE通知に応答してこのハンドルを提供しました。

[in] Component

コンポーネントを識別するインデックス。このメンバーは、このデバイスのPEP_DPM_REGISTER_DEVICE通知に応答して PEP が以前に指定したPEP_DEVICE_REGISTER_V2構造体の Components 配列へのインデックスです。 Components 配列に N 個の要素が含まれている場合、コンポーネントインデックスの範囲は 0 から N ~ 1 です。

[in] Set

この P 状態セットを識別するインデックス。このコンポーネントに M P 状態セットがある場合、P 状態セットのインデックスの範囲は 0 から M – 1 です。 PEP は以前、 PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES 通知に応答して P 状態セットの数を指定しました。

[in, NameSize

入力時に、 Name メンバーが指すバッファーのサイズ (バイト単位)。 Name が NULL の場合、PEP は NameSize の入力値を名前文字列に必要なバッファーサイズで上書きします。

[in] Name

出力バッファーへのポインター。 PEP は、P 状態の名前をこのバッファーに書き込みます。名前は、ワイド文字の null で終わる文字列として格納されます。 Windows 電源管理フレームワーク (PoFx) が名前文字列に割り当てるバッファーの大きさを決定する必要がある場合、 Name メンバーは NULL です。 Name が NULL 以外の場合、バッファーは、終端の null 文字を含む文字列全体を格納するのに十分な大きさにする必要があります。

注釈

この構造体は、 PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME 通知によって使用されます。構造体の DeviceHandle、 Component、 および Set メンバーには、この通知の送信時に PoFx によって提供される入力値が含まれます。 Name メンバーが NULL 以外の場合、PEP は Name が指すバッファーに文字列を書き込みます。 Name が NULL の場合、PEP は必要なバッファーサイズを NameSize メンバーに書き込みます。

PEP が出力バッファーに書き込む文字列には、P 状態セットのわかりやすい名前が含まれている必要があります。この名前は、ログエントリと診断メッセージを理解しやすくするためのものです。