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 です。 名前 が NULL 以外の場合、バッファーは、終端の null 文字を含む文字列全体を格納するのに十分な大きさである必要があります。
備考
この構造体は、PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME 通知によって使用されます。 DeviceHandle、コンポーネント、および Set 構造体のメンバーには、この通知の送信時に PoFx によって提供される入力値が含まれます。 Name メンバーが NULL 以外の場合、PEP は Nameが指すバッファーに文字列を書き込みます。 Name が NULL の場合、PEP は必要なバッファー サイズを NameSize メンバーに書き込みます。
PEP が出力バッファーに書き込む文字列には、P 状態セットのわかりやすい名前が含まれている必要があります。 この名前は、ログ エントリと診断メッセージを理解しやすくするためのものです。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 10 以降でサポートされています。 |
| ヘッダー | pep_x.h (Pep_x.h を含む) |
関連項目
PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES