PerfAddCounters 函式 (perflib.h)

將效能計數器規格新增至指定的查詢。

語法

ULONG PerfAddCounters(
  [in]      HANDLE                   hQuery,
  [in, out] PPERF_COUNTER_IDENTIFIER pCounters,
            DWORD                    cbCounters
);

參數

[in] hQuery

您要在其中加入效能計數器規格之查詢的控制碼。

[in, out] pCounters

您想要加入的效能計數器規格指標。

cbCounters

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

傳回值

如果函式成功，則會傳回ERROR_SUCCESS。

如果函式失敗，則傳回值是 系統錯誤碼。

備註

pCounters參數應該指向一連串PERF_COUNTER_IDENTIFIER區塊。 每個 PERF_COUNTER_IDENTIFIER 區塊都包含 PERF_COUNTER_IDENTIFIER 結構，選擇性地後面接著以 Null 終止的 UTF-16LE 實例名稱字串，後面接著填補，讓區塊的大小成為 8 個位元組的倍數。

針對每個 PERF_COUNTER_IDENTIFIER 區塊：

• 將PERF_COUNTER_IDENTIFIER結構的CounterSetGuid成員設定為要查詢之計數器集的識別碼。
• 將PERF_COUNTER_IDENTIFIER結構的Status成員設定為 0。
• 將PERF_COUNTER_IDENTIFIER結構的Size成員設定為位元組PERF_COUNTER_IDENTIFIER區塊的大小，包括PERF_COUNTER_IDENTIFIER結構、實例名稱和填補。 Size的值必須是 8 的倍數。
• 將PERF_COUNTER_IDENTIFIER結構的CounterId成員設定為查詢應該傳回之計數器的識別碼。 若要傳回所有計數器，請將 CounterId 設定為 PERF_WILDCARD_COUNTER。
• 將PERF_COUNTER_IDENTIFIER結構的InstanceId成員設定為查詢應該傳回之實例的識別碼。 如果不應該根據實例識別碼進行篩選，請將 InstanceId 設定為 PERF_WILDCARD_COUNTER。
• 將PERF_COUNTER_IDENTIFIER結構的Index成員設定為 0。
• 將PERF_COUNTER_IDENTIFIER結構的保留成員設定為 0。
• 在 PERF_COUNTER_IDENTIFIER 結構之後立即包含實例名稱。
  • 如果計數器集是單一實例，請勿設定實例名稱。 在此情況下， PERF_COUNTER_IDENTIFIER 結構之 Size 成員的值必須是 PERF_COUNTER_IDENTIFIER 結構的大小。
  • 如果計數器集是多個實例，您必須設定實例名稱。 如果您不想根據實例名稱篩選效能計數器規格，請使用 PERF_WILDCARD_INSTANCE 作為實例名稱。

需求

另請參閱

PERF_COUNTER_IDENTIFIER

PerfDeleteCounters