次の方法で共有


PEP_QUERY_COMPONENT_PERF_SET_NAME構造体 (pep_x.h)

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

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

要件

要件
サポートされている最小のクライアント Windows 10 以降でサポートされています。
Header pep_x.h (Pep_x.h を含む)

こちらもご覧ください

PEP_DEVICE_REGISTER_V2

PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES

PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME

PEP_DPM_REGISTER_DEVICE