perfQueryCounterData 函式 (perflib.h)

  • 發行項

取得符合指定查詢中計數器規格的效能計數器值。

語法

ULONG PerfQueryCounterData(
  [in]            HANDLE            hQuery,
  [out, optional] PPERF_DATA_HEADER pCounterBlock,
                  DWORD             cbCounterBlock,
  [out]           LPDWORD           pcbCounterBlockActual
);

參數

[in] hQuery

要取得值之效能計數器規格之計數器規格的查詢控制碼。

[out, optional] pCounterBlock

緩衝區的指標，其有足夠的空間可接收 cbCounterBlock 參數所指定的資料量，以位元組為單位。 如果 為 Null，則為 Null

cbCounterBlock 為 0。

cbCounterBlock

pCounterBlock參數所指定的緩衝區大小，以位元組為單位。

[out] pcbCounterBlockActual

取得效能計數器值所需的緩衝區大小。 意義取決於函式的值

返回。

函式傳回值 其意義
ERROR_SUCCESS 的數目

函式儲存在 pCounterBlock 所指定緩衝區中的效能計數器值的位元組。
ERROR_NOT_ENOUGH_MEMORY 此

儲存效能計數器值所需的緩衝區大小，以位元組為單位。 將緩衝區放大為所需的

大小並再次呼叫 函式。
其他 此值未定義且不應使用。

傳回值

傳回碼 描述
ERROR_SUCCESS
 函式已成功將所有要求的效能計數器值儲存在 pCounterBlock 指定的緩衝區中。 以位元組為單位，表示實際儲存在緩衝區中之資訊量 ，而其值 會以位元組為單位。
ERROR_NOT_ENOUGH_MEMORY
 pCounterBlock指定的緩衝區不夠大，無法儲存所有要求的效能計數器值。 其值會指出儲存所有資訊所需的緩衝區大小。 將緩衝區放大為所需的

大小並再次呼叫 函式。
 

對於其他類型的失敗，傳回值是 系統錯誤碼。

備註

效能計數器值的相關資訊會寫入 pCounterBlock 指定為 PERF_DATA_HEADER 區塊的緩衝區，其中包含 PERF_DATA_HEADER 結構，後面接著一連串 PERF_COUNTER_HEADER 區塊。

需求

   
最低支援的用戶端 Windows 10 1607 版 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2016 [僅限傳統型應用程式]
目標平台 Windows
標頭 perflib.h
程式庫 AdvAPI32.lib
Dll AdvAPI32.dll

另請參閱

PERF_COUNTER_HEADER

PERF_DATA_HEADER