PdhGetCounterTimeBase 함수(pdh.h)

지정된 카운터의 시간 기반을 반환합니다.

구문

PDH_FUNCTION PdhGetCounterTimeBase(
  [in]  PDH_HCOUNTER hCounter,
  [out] LONGLONG     *pTimeBase
);

[in] hCounter

카운터에 대한 핸들입니다. PdhAddCounter 함수는 이 핸들을 반환합니다.

[out] pTimeBase

카운터 샘플의 초당 성능 값 수를 지정하는 시간 기준입니다.

함수가 성공하면 ERROR_SUCCESS 반환합니다.

함수가 실패하면 반환 값은 시스템 오류 코드 또는 PDH 오류 코드입니다. 가능한 값은 다음과 같습니다.

반환 코드	설명
PDH_INVALID_ARGUMENT	지정된 카운터는 시간 기반을 사용하지 않습니다.
PDH_INVALID_HANDLE	카운터 핸들이 잘못되었습니다.

PdhFormatFromRawValue 함수를 사용하여 PdhCalculateCounterFromRawValue 함수를 호출하는 대신 표시 가능한 값을 계산하는 경우 PdhGetCounterTimeBase 함수를 호출하여 시간 기반을 검색해야 합니다.

시간 기반 성능 데이터를 반환하는 각 카운터에는 시간 기준이 정의되어 있습니다. 카운터의 시간 기준은 카운터가 초당 데이터를 샘플하는 횟수입니다.