PerfQueryInstance 関数 (perflib.h)

指定したカウンター セット インスタンスへのポインターを取得します。 プロバイダーはこの関数を使用します。

構文

PPERF_COUNTERSET_INSTANCE PerfQueryInstance(
  [in] HANDLE  ProviderHandle,
  [in] LPCGUID CounterSetGuid,
  [in] PCWSTR  Name,
  [in] ULONG   Id
);

パラメーター

[in] ProviderHandle

プロバイダーのハンドル。 CTRPP ツールによって生成されたハンドル変数を使用します。 変数の名前については、provider 要素の symbol 属性を参照してください。

Windows Vista: PerfStartProvider 関数はハンドルを返します。

[in] CounterSetGuid

クエリを実行するカウンター セットを一意に識別する GUID。 これは、counterSet 要素の guid 属性で指定されたのと同じ GUID です。 CTRPP ツールによって生成された GUID 変数を使用します。 変数の名前については、counterSet 要素の symbol 属性を参照してください。

Windows Vista: GUID 変数は使用できません。

[in] Name

取得するカウンター セット インスタンスの名前を含む Null で終わる Unicode 文字列。

[in] Id

取得するカウンター セット インスタンスの一意識別子。

戻り値

カウンター セット インスタンスを含む PERF_COUNTERSET_INSTANCE 構造体。インスタンスが存在しない場合は NULL 。

エラーが発生した場合、この関数は NULL を 返します。 発生したエラーを確認するには、 GetLastError を呼び出します。

解説

PerfCreateInstance を呼び出すときと同じインスタンス名と識別子を使用して、カウンター セットの特定のインスタンスを取得します。

プロバイダーは、この関数を呼び出してポインターを取得するのではなく、インスタンスを作成するときに、インスタンスへのポインターをキャッシュする必要があります。

要件

関連項目

PerfCreateInstance