PdhAddCounter パフォーマンスカウンタをクエリーに追加

Cの宣言:

PDH_STATUS PdhAddCounter(
	IN HQUERY hQuery,
	IN LPCTSTR CounterPath,
	IN DWORD UserData,
	IN HCOUNTER *hCounter);

説明:

hQueryで指定したクエリーにCounterPathで指定したカウンタを追加する。

引数の意味は以下の通り。
hQuery (IN) 追加先のクエリーのハンドル。
CounterPath (IN) 追加するカウンタのパス。
UserData (IN) カウンタと共に追加するユーザ定義のデータ
hCounter (OUT) 追加結果のカウンタのハンドル。

Cのサンプル:

ローカルマシン上で既に起動してあるメモ帳のCPU使用率を10秒間計測し、結果を表示する。
/* メモ帳のCPU使用率を表示 */
void DispTime()
{
	HQUERY hQuery;
	HCOUNTER hCounter;

	PDH_FMT_COUNTERVALUE FmtValue;

	/* 新規クエリーを作成 */
	PdhOpenQuery(NULL, 0, &hQuery);

	/* 既に起動しているメモ帳のCPU使用率のカウンタをクエリーに追加 */
	PdhAddCounter(hQuery, "\\Process(notepad#0)\\% Processor Time", 0, &hCounter);

	/* 計測 */
	printf("計測開始...\n");
	PdhCollectQueryData(hQuery);

	Sleep(10000); /* 十秒間待つ */

	PdhCollectQueryData(hQuery);
	printf("計測終了.\n");

	/* 今の十秒間での、メモ帳のCPUの使用率を表示 */

	PdhGetFormattedCounterValue(hCounter, PDH_FMT_DOUBLE, NULL, &FmtValue);
	printf("メモ帳のCPU使用率: %f%%\n", FmtValue.doubleValue);

	/* 終了 */
	PdhCloseQuery(hQuery);
}

(original text:1999/01/05 更新)

本ドキュメントの内容は保証しません。本ドキュメントによって生じた結果について、一切の責任を負いません。