PdhFormatFromRawValue 함수(pdh.h)
지정된 원시 카운터 값에 대해 표시 가능한 값을 계산합니다.
구문
PDH_FUNCTION PdhFormatFromRawValue(
[in] DWORD dwCounterType,
[in] DWORD dwFormat,
[in] LONGLONG *pTimeBase,
[in] PPDH_RAW_COUNTER pRawValue1,
[in] PPDH_RAW_COUNTER pRawValue2,
[out] PPDH_FMT_COUNTERVALUE pFmtValue
);
매개 변수
[in] dwCounterType
카운터의 유형입니다. 일반적으로 PdhGetCounterInfo 를 호출하여 PdhGetRawCounterValue 를 호출할 때 카운터 형식을 검색하여 원시 카운터 값을 검색합니다.
카운터 유형 목록은 Windows Server 2003 배포 키트의 카운터 유형 섹션을 참조하세요. 상수 값은 Winperf.h에 정의되어 있습니다.
기본 형식(예: PERF_LARGE_RAW_BASE)을 지정할 수 없습니다.
[in] dwFormat
계산된 값의 데이터 형식을 결정합니다. 다음 값 중 하나를 지정합니다.
| 값 | 의미 |
|---|---|
|
계산된 값을 배정밀도 부동 소수점 real로 반환합니다. |
|
계산된 값을 64비트 정수로 반환합니다. |
|
계산된 값을 long 정수로 반환합니다. |
비트 포함 OR 연산자(|)를 사용하여 데이터 형식을 다음 배율 인수 중 하나와 결합할 수 있습니다.
[in] pTimeBase
형식 변환에 필요한 경우 시간 기반에 대한 포인터입니다. 형식 변환에 시간축 정보가 필요하지 않은 경우 이 매개 변수의 값은 무시됩니다. 카운터의 시간 기반을 검색하려면 PdhGetCounterTimeBase를 호출합니다.
[in] pRawValue1
표시 가능한 카운터 값을 계산하는 데 사용되는 원시 카운터 값입니다. 자세한 내용은 PDH_RAW_COUNTER.
[in] pRawValue2
표시 가능한 카운터 값을 계산하는 데 사용되는 원시 카운터 값입니다. 자세한 내용은 PDH_RAW_COUNTER. 일부 카운터(예: 속도 카운터)에는 표시 가능한 값을 계산하려면 두 개의 원시 값이 필요합니다. 카운터 형식에 두 번째 값이 필요하지 않은 경우 이 매개 변수를 NULL로 설정합니다. 이 값은 두 원시 값 중 이전 값이어야 합니다.
[out] pFmtValue
계산된 카운터 값을 받는 PDH_FMT_COUNTERVALUE 구조체입니다.
반환 값
함수가 성공하면 ERROR_SUCCESS 반환합니다.
함수가 실패하면 반환 값은 시스템 오류 코드 또는 PDH 오류 코드입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | pdh.h |
| 라이브러리 | Pdh.lib |
| DLL | Pdh.dll |