PerfQueryCounterSetRegistrationInfo 関数 (perflib.h)

指定したシステムのカウンター セットに関する情報を取得します。

構文

ULONG PerfQueryCounterSetRegistrationInfo(
  [in, optional]  LPCWSTR         szMachine,
  [in]            LPCGUID         pCounterSetId,
                  PerfRegInfoType requestCode,
                  DWORD           requestLangId,
  [out, optional] LPBYTE          pbRegInfo,
                  DWORD           cbRegInfo,
  [out]           LPDWORD         pcbRegInfoActual
);

パラメーター

[in, optional] szMachine

pCounterSet パラメーターが指定するカウンター セットに関する情報を取得するコンピューターの名前。 NULL の場合、関数はローカル コンピューターの指定したカウンター セットに関する情報を取得します。

[in] pCounterSetId

情報を取得するカウンター セットのカウンター セット識別子。

requestCode

カウンター セットについて取得する情報の種類。 使用可能な値の一覧については、「 PerfRegInfoType 」を参照してください。

requestLangId

requestCode がPERF_REG_COUNTERSET_NAME_STRINGの場合、要求された情報を含む文字列の優先ロケール識別子。

PERF_REG_COUNTERSET_HELP_STRING、 PERF_REG_COUNTER_NAME_STRINGS、または

PERF_REG_COUNTER_HELP_STRINGS。

requestCode がPERF_REG_COUNTER_STRUCTされている場合、データが必要なカウンターのカウンター識別子。

requestCode の他のすべての値については、0 に設定します。

[out, optional] pbRegInfo

cbRegInfo パラメーターが指定するデータ量をバイト単位で受け取るのに十分な大きさのバッファーへのポインター。 たぶん

cbRegInfo が 0 の場合は NULL。

cbRegInfo

pbRegInfo パラメーターが指定するバッファーのサイズ (バイト単位)。

[out] pcbRegInfoActual

カウンター セットに関する情報を取得するために実際に必要なバッファーのサイズ。 意味は、関数の値によって異なります

返します。

戻り値

その他の種類のエラーの場合、戻り値は システム エラー コードです。

解説

要求できるデータの種類については、「 PerfRegInfoType 」を参照してください。

要求の種類ごとに提供されるデータの形式。

要件