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 函式來擷取時間基底。

每個傳回以時間為基礎的效能資料計數器都會為其定義時間基底。計數器的時間基底是計數器每秒取樣資料的次數。