效能計數器

效能計數器技術概觀。

若要開發效能計數器，您需要下列標頭：

• pdh.h
• perflib.h
• winperf.h

如需這項技術的程式設計指導方針，請參閱：

• 效能計數器

列舉

PerfCounterDataType 指出 PerfQueryCounterData 函式包含之PERF_COUNTER_HEADER區塊的內容類型，做為函式產生輸出之PERF_DATA_HEADER區塊的一部分。
PerfRegInfoType 指出您可以藉由呼叫 PerfQueryCounterSetRegistrationInfo 函式來要求有關效能計數器集的資訊類型。

函式

CounterPathCallBack 應用程式會實作 CounterPathCallBack 函式，以處理 [流覽] 對話方塊所傳回的計數器路徑字串。
LoadPerfCounterTextStringsA 將效能物件和計數器載入至電腦，這些計數器定義于指定的初始化檔案中。 (ANSI)
LoadPerfCounterTextStringsW 將效能物件和計數器載入至電腦，這些計數器定義于指定的初始化檔案中。 (Unicode)
PdhAddCounterA 將指定的計數器加入至查詢。 (ANSI)
PdhAddCounterW 將指定的計數器加入至查詢。 (Unicode)
PdhAddEnglishCounterA 將指定的語言中性計數器新增至查詢。 (ANSI)
PdhAddEnglishCounterW 將指定的語言中性計數器新增至查詢。 (Unicode)
PdhBindInputDataSourceA 將一或多個二進位記錄檔系結在一起，以讀取記錄資料。 (ANSI)
PdhBindInputDataSourceW 將一或多個二進位記錄檔系結在一起，以讀取記錄資料。 (Unicode)
PdhBrowseCountersA 顯示 [流覽計數器] 對話方塊，讓使用者可用來選取想要新增至查詢的一或多個計數器。 若要使用資料來源的控制碼，請使用 PdhBrowseCountersH 函式。 (ANSI)
PdhBrowseCountersHA 顯示 [流覽計數器] 對話方塊，讓使用者可用來選取想要新增至查詢的一或多個計數器。 此函式與 PdhBrowseCounters 函式相同，不同之處在于它支援使用資料來源的控制碼。 (ANSI)
PdhBrowseCountersHW 顯示 [流覽計數器] 對話方塊，讓使用者可用來選取想要新增至查詢的一或多個計數器。 此函式與 PdhBrowseCounters 函式相同，不同之處在于它支援使用資料來源的控制碼。 (Unicode)
PdhBrowseCountersW 顯示 [流覽計數器] 對話方塊，讓使用者可用來選取想要新增至查詢的一或多個計數器。 若要使用資料來源的控制碼，請使用 PdhBrowseCountersH 函式。 (Unicode)
PdhCalculateCounterFromRawValue 計算兩個原始計數器值的可顯示值。
PdhCloseLog 關閉指定的記錄檔。
PdhCloseQuery 關閉指定查詢中包含的所有計數器、關閉與查詢相關的所有控制碼，並釋放與查詢相關聯的所有記憶體。
PdhCollectQueryData 收集指定查詢中所有計數器的目前原始資料值，並更新每個計數器的狀態碼。 (PdhCollectQueryData)
PdhCollectQueryDataEx 使用個別執行緒收集指定查詢中所有計數器的目前原始資料值。 然後函式會發出應用程式定義的事件訊號，並在傳回之前等候指定的時間間隔。
PdhCollectQueryDataWithTime 收集指定查詢中所有計數器的目前原始資料值，並更新每個計數器的狀態碼。 (PdhCollectQueryDataWithTime)
PdhComputeCounterStatistics 從原始值陣列計算計數器的統計資料。
PdhConnectMachineA 連接到指定的電腦。 (ANSI)
PdhConnectMachineW 連接到指定的電腦。 (Unicode)
PdhEnumLogSetNamesA 列舉 DSN 內的記錄集名稱。 (ANSI)
PdhEnumLogSetNamesW 列舉 DSN 內的記錄集名稱。 (Unicode)
PdhEnumMachinesA 傳回與記錄檔中計數器相關聯的電腦名稱稱清單。 (PdhEnumMachinesA)
PdhEnumMachinesHA 傳回與記錄檔中計數器相關聯的電腦名稱稱清單。 (PdhEnumMachinesHA)
PdhEnumMachinesHW 傳回與記錄檔中計數器相關聯的電腦名稱稱清單。 (PdhEnumMachinesHW)
PdhEnumMachinesW 傳回與記錄檔中計數器相關聯的電腦名稱稱清單。 (PdhEnumMachinesW)
PdhEnumObjectItemsA 傳回存在於指定電腦或指定記錄檔中的指定物件的計數器和實例名稱。 若要使用資料來源的控制碼，請使用 PdhEnumObjectItemsH 函式。 (ANSI)
PdhEnumObjectItemsHA 傳回存在於指定電腦或指定記錄檔中的指定物件的計數器和實例名稱。 此函式與 PdhEnumObjectItems 函式相同，不同之處在于它支援使用資料來源的控制碼。 (ANSI)
PdhEnumObjectItemsHW 傳回存在於指定電腦或指定記錄檔中的指定物件的計數器和實例名稱。 此函式與 PdhEnumObjectItems 函式相同，不同之處在于它支援使用資料來源的控制碼。 (Unicode)
PdhEnumObjectItemsW 傳回存在於指定電腦或指定記錄檔中的指定物件的計數器和實例名稱。 若要使用資料來源的控制碼，請使用 PdhEnumObjectItemsH 函式。 (Unicode)
PdhEnumObjectsA 傳回指定電腦上或指定記錄檔中可用的物件清單。 若要使用資料來源的控制碼，請使用 PdhEnumObjectsH 函式。 (ANSI)
PdhEnumObjectsHA 傳回指定電腦上或指定記錄檔中可用的物件清單。此函式與 PdhEnumObjects 相同，不同之處在于它支援使用資料來源的控制碼。 (ANSI)
PdhEnumObjectsHW 傳回指定電腦上或指定記錄檔中可用的物件清單。此函式與 PdhEnumObjects 相同，不同之處在于它支援使用資料來源的控制碼。 (Unicode)
PdhEnumObjectsW 傳回指定電腦上或指定記錄檔中可用的物件清單。 若要使用資料來源的控制碼，請使用 PdhEnumObjectsH 函式。 (Unicode)
PdhExpandCounterPathA 如果未針對計數器路徑中符合萬用字元字串的計數器和計數器實例) ，檢查指定的電腦 (或本機電腦。 (ANSI)
PdhExpandCounterPathW 如果未針對計數器路徑中符合萬用字元字串的計數器和計數器實例) ，檢查指定的電腦 (或本機電腦。 (Unicode)
PdhExpandWildCardPathA 檢查指定的電腦或記錄檔，並傳回符合包含萬用字元之指定計數器路徑的計數器路徑。 若要使用資料來源的控制碼，請使用 PdhExpandWildCardPathH 函式。 (ANSI)
PdhExpandWildCardPathHA 檢查指定的電腦或記錄檔，並傳回符合包含萬用字元之指定計數器路徑的計數器路徑。此函式與 PdhExpandWildCardPath 函式相同，不同之處在于它支援使用資料來源的控制碼。 (ANSI)
PdhExpandWildCardPathHW 檢查指定的電腦或記錄檔，並傳回符合包含萬用字元之指定計數器路徑的計數器路徑。此函式與 PdhExpandWildCardPath 函式相同，不同之處在于它支援使用資料來源的控制碼。 (Unicode)
PdhExpandWildCardPathW 檢查指定的電腦或記錄檔，並傳回符合包含萬用字元之指定計數器路徑的計數器路徑。 若要使用資料來源的控制碼，請使用 PdhExpandWildCardPathH 函式。 (Unicode)
PdhFormatFromRawValue 計算指定原始計數器值的可顯示值。
PdhGetCounterInfoA 擷取計數器的相關資訊，例如資料大小、計數器類型、路徑和使用者提供的資料值。 (ANSI)
PdhGetCounterInfoW 擷取計數器的相關資訊，例如資料大小、計數器類型、路徑和使用者提供的資料值。 (Unicode)
PdhGetCounterTimeBase 傳回指定計數器的時間基底。
PdhGetDataSourceTimeRangeA 決定時間範圍、專案數目，以及如果適用的話，包含指定輸入來源之效能資料的緩衝區大小。 若要使用資料來源的控制碼，請使用 PdhGetDataSourceTimeRangeH 函式。 (ANSI)
PdhGetDataSourceTimeRangeH 決定時間範圍、專案數目，以及如果適用的話，包含指定輸入來源之效能資料的緩衝區大小。此函式與 PdhGetDataSourceTimeRange 函式相同，不同之處在于它支援使用資料來源的控制碼。
PdhGetDataSourceTimeRangeW 決定時間範圍、專案數目，以及如果適用的話，包含指定輸入來源之效能資料的緩衝區大小。 若要使用資料來源的控制碼，請使用 PdhGetDataSourceTimeRangeH 函式。 (Unicode)
PdhGetDefaultPerfCounterA 擷取指定物件的預設計數器名稱。 此名稱可用來設定 [流覽計數器] 對話方塊中的初始計數器選取範圍。 若要使用資料來源的控制碼，請使用 PdhGetDefaultPerfCounterH 函式。 (ANSI)
PdhGetDefaultPerfCounterHA 擷取指定物件的預設計數器名稱。 (ANSI)
PdhGetDefaultPerfCounterHW 擷取指定物件的預設計數器名稱。 (Unicode)
PdhGetDefaultPerfCounterW 擷取指定物件的預設計數器名稱。 此名稱可用來設定 [流覽計數器] 對話方塊中的初始計數器選取範圍。 若要使用資料來源的控制碼，請使用 PdhGetDefaultPerfCounterH 函式。 (Unicode)
PdhGetDefaultPerfObjectA 擷取預設物件的名稱。 此名稱可用來設定 [流覽計數器] 對話方塊中的初始物件選取範圍。 若要使用資料來源的控制碼，請使用 PdhGetDefaultPerfObjectH 函式。 (ANSI)
PdhGetDefaultPerfObjectHA 擷取預設物件的名稱。 (ANSI)
PdhGetDefaultPerfObjectHW 擷取預設物件的名稱。 (Unicode)
PdhGetDefaultPerfObjectW 擷取預設物件的名稱。 此名稱可用來設定 [流覽計數器] 對話方塊中的初始物件選取範圍。 若要使用資料來源的控制碼，請使用 PdhGetDefaultPerfObjectH 函式。 (Unicode)
PdhGetDllVersion 傳回目前安裝 Pdh.dll 檔案的版本。
PdhGetFormattedCounterArrayA 傳回格式化計數器值的陣列。 當您想要格式化包含實例名稱萬用字元之計數器的計數器值時，請使用此函式。 (ANSI)
PdhGetFormattedCounterArrayW 傳回格式化計數器值的陣列。 當您想要格式化包含實例名稱萬用字元之計數器的計數器值時，請使用此函式。 (Unicode)
PdhGetFormattedCounterValue 計算指定計數器的可顯示值。
PdhGetLogFileSize 傳回指定之記錄檔的大小。
PdhGetRawCounterArrayA 從指定的計數器傳回原始值的陣列。 當您想要擷取包含實例名稱萬用字元之計數器的原始計數器值時，請使用此函式。 (ANSI)
PdhGetRawCounterArrayW 從指定的計數器傳回原始值的陣列。 當您想要擷取包含實例名稱萬用字元之計數器的原始計數器值時，請使用此函式。 (Unicode)
PdhGetRawCounterValue 傳回計數器目前的原始值。
PdhIsRealTimeQuery 判斷指定的查詢是否為即時查詢。
PdhLookupPerfIndexByNameA 傳回對應至指定計數器名稱的計數器索引。 (ANSI)
PdhLookupPerfIndexByNameW 傳回對應至指定計數器名稱的計數器索引。 (Unicode)
PdhLookupPerfNameByIndexA 傳回對應至指定索引的效能物件名稱或計數器名稱。 (ANSI)
PdhLookupPerfNameByIndexW 傳回對應至指定索引的效能物件名稱或計數器名稱。 (Unicode)
PdhMakeCounterPathA 使用 PDH_COUNTER_PATH_ELEMENTS 結構中指定的成員，建立完整的計數器路徑。 (ANSI)
PdhMakeCounterPathW 使用 PDH_COUNTER_PATH_ELEMENTS 結構中指定的成員，建立完整的計數器路徑。 (Unicode)
PdhOpenLogA 開啟指定的記錄檔以供讀取或寫入。 (ANSI)
PdhOpenLogW 開啟指定的記錄檔以供讀取或寫入。 (Unicode)
PdhOpenQueryA 建立用來管理效能資料收集的新查詢。 若要使用資料來源的控制碼，請使用 PdhOpenQueryH 函式。 (ANSI)
PdhOpenQueryH 建立用來管理效能資料收集的新查詢。 此函式與 PdhOpenQuery 函式相同，不同之處在于它支援對資料來源使用控制碼。
PdhOpenQueryW 建立用來管理效能資料收集的新查詢。 若要使用資料來源的控制碼，請使用 PdhOpenQueryH 函式。 (Unicode)
PdhParseCounterPathA 剖析計數器路徑的專案，並將結果儲存在PDH_COUNTER_PATH_ELEMENTS結構中。 (ANSI)
PdhParseCounterPathW 剖析計數器路徑的專案，並將結果儲存在PDH_COUNTER_PATH_ELEMENTS結構中。 (Unicode)
PdhParseInstanceNameA 剖析實例字串的專案。 (ANSI)
PdhParseInstanceNameW 剖析實例字串的專案。 (Unicode)
PdhReadRawLogRecord 讀取指定二進位追蹤記錄檔中的資訊。
PdhRemoveCounter 從查詢中移除計數器。
PdhSelectDataSourceA 顯示對話方塊視窗，提示使用者指定效能資料的來源。 (ANSI)
PdhSelectDataSourceW 顯示對話方塊視窗，提示使用者指定效能資料的來源。 (Unicode)
PdhSetCounterScaleFactor 設定當您要求格式化計數器值時，套用至指定計數器計算值的縮放比例。 如果已設定PDH_FMT_NOSCALE旗標，則會忽略此縮放比例。
PdhSetDefaultRealTimeDataSource 指定即時資料的來源。
PdhSetQueryTimeRange 將您可以從記錄檔讀取的範例限制為包含指定時間範圍內的範例。
PdhUpdateLogA 收集目前查詢的計數器資料，並將資料寫入記錄檔。 (ANSI)
PdhUpdateLogFileCatalog 同步處理記錄檔目錄中的資訊與記錄檔中的效能資料。
PdhUpdateLogW 收集目前查詢的計數器資料，並將資料寫入記錄檔。 (Unicode)
PdhValidatePathA 驗證計數器是否存在於計數器路徑中指定的電腦上。 (ANSI)
PdhValidatePathExA 驗證指定的計數器存在於電腦或記錄檔中。 (ANSI)
PdhValidatePathExW 驗證指定的計數器存在於電腦或記錄檔中。 (Unicode)
PdhValidatePathW 驗證計數器是否存在於計數器路徑中指定的電腦上。 (Unicode)
PERF_MEM_ALLOC 提供者會實作此函式，以提供 PERFLIB 的自訂記憶體管理。A
PERF_MEM_FREE 提供者會實作此函式，以提供 PERFLIB 的自訂記憶體管理。F
PerfAddCounters 將效能計數器規格新增至指定的查詢。
PerfCloseQueryHandle 關閉您藉由呼叫 PerfOpenQueryHandle 開啟的查詢控制碼。
PerfCreateInstance 建立指定之計數器集的實例。
PerfDecrementULongCounterValue 遞減計數器的值，其值為 4 位元組不帶正負號的整數。 提供者會使用此函式。
PerfDecrementULongLongCounterValue 遞減計數器的值，其值為 8 位元組不帶正負號的整數。 提供者會使用此函式。
PerfDeleteCounters 從指定的查詢中移除指定的效能計數器規格。
PerfDeleteInstance 刪除 PerfCreateInstance 函式所建立之計數器集的實例。
PerfEnumerateCounterSet 取得在指定系統上註冊之計數器集的計數器集識別碼。 計數器集識別碼是全域唯一識別碼， (GUID) 。
PerfEnumerateCounterSetInstances 取得指定系統上所設定之計數器之作用中實例的名稱和識別碼。
PerfIncrementULongCounterValue 遞增計數器的值，其值為 4 位元組不帶正負號的整數。 提供者會使用此函式。
PerfIncrementULongLongCounterValue 遞增計數器的值，其值為 8 位元組不帶正負號的整數。 提供者會使用此函式。
PERFLIBREQUEST 提供者可以在取用者執行特定動作時實作此函式來接收通知，例如從查詢新增或移除計數器。
PerfOpenQueryHandle 建立控制碼，參考指定系統上的查詢。 查詢是計數器規格的清單。
PerfQueryCounterData 取得符合指定查詢中計數器規格的效能計數器值。
PerfQueryCounterInfo 取得指定查詢中的計數器規格。
PerfQueryCounterSetRegistrationInfo 取得指定系統上之計數器集的相關資訊。
PerfQueryInstance 擷取指定計數器集實例的指標。 提供者會使用此函式。
PerfSetCounterRefValue 更新計數器的值，其值為實際資料的指標。 提供者會使用此函式。
PerfSetCounterSetInfo 指定特定計數器集的配置。
PerfSetULongCounterValue 更新值為 4 位元組不帶正負號的整數的計數器值。 提供者會使用此函式。
PerfSetULongLongCounterValue 更新值為 8 位元組不帶正負號的整數的計數器值。 提供者會使用此函式。
PerfStartProvider 註冊提供者。 (PerfStartProvider)
PerfStartProviderEx 註冊提供者。 (PerfStartProviderEx)
PerfStopProvider 從已註冊的提供者清單中移除提供者的註冊，並釋放與提供者相關聯的所有資源。
PM_CLOSE_PROC 執行效能 DLL 所需的清除。
PM_COLLECT_PROC 收集效能資料，並將其傳回給取用者。
UnloadPerfCounterTextStringsA 從指定的應用程式的電腦卸載效能物件和計數器。 (ANSI)
UnloadPerfCounterTextStringsW 從指定的應用程式的電腦卸載效能物件和計數器。 (Unicode)

結構

PDH_BROWSE_DLG_CONFIG_A PdhBrowseCounters 函式會使用PDH_BROWSE_DLG_CONFIG結構來設定 [流覽效能計數器] 對話方塊。 (ANSI)
PDH_BROWSE_DLG_CONFIG_HA PdhBrowseCountersH 函式會使用PDH_BROWSE_DLG_CONFIG_H結構來設定 [流覽效能計數器] 對話方塊。 (ANSI)
PDH_BROWSE_DLG_CONFIG_HW PdhBrowseCountersH 函式會使用PDH_BROWSE_DLG_CONFIG_H結構來設定 [流覽效能計數器] 對話方塊。 (Unicode)
PDH_BROWSE_DLG_CONFIG_W PdhBrowseCounters 函式會使用PDH_BROWSE_DLG_CONFIG結構來設定 [流覽效能計數器] 對話方塊。 (Unicode)
PDH_COUNTER_INFO_A PDH_COUNTER_INFO 結構包含描述計數器屬性的資訊。 此資訊也包含計數器路徑。 (ANSI)
PDH_COUNTER_INFO_W PDH_COUNTER_INFO 結構包含描述計數器屬性的資訊。 此資訊也包含計數器路徑。 (Unicode)
PDH_COUNTER_PATH_ELEMENTS_A PDH_COUNTER_PATH_ELEMENTS 結構包含計數器路徑的元件。 (ANSI)
PDH_COUNTER_PATH_ELEMENTS_W PDH_COUNTER_PATH_ELEMENTS 結構包含計數器路徑的元件。 (Unicode)
PDH_DATA_ITEM_PATH_ELEMENTS_A PDH_DATA_ITEM_PATH_ELEMENTS 結構包含特定資料項目的路徑專案。 (ANSI)
PDH_DATA_ITEM_PATH_ELEMENTS_W PDH_DATA_ITEM_PATH_ELEMENTS 結構包含特定資料項目的路徑專案。 (Unicode)
PDH_FMT_COUNTERVALUE PDH_FMT_COUNTERVALUE 結構包含計數器及其狀態的計算值。
PDH_FMT_COUNTERVALUE_ITEM_A PDH_FMT_COUNTERVALUE_ITEM 結構包含計數器的實例名稱和格式化值。 (ANSI)
PDH_FMT_COUNTERVALUE_ITEM_W PDH_FMT_COUNTERVALUE_ITEM 結構包含計數器的實例名稱和格式化值。 (Unicode)
PDH_RAW_COUNTER PDH_RAW_COUNTER 結構會傳回從計數器提供者收集的資料。 不會對資料執行轉譯、格式化或其他解譯。
PDH_RAW_COUNTER_ITEM_A PDH_RAW_COUNTER_ITEM 結構包含計數器的實例名稱和原始值。 (ANSI)
PDH_RAW_COUNTER_ITEM_W PDH_RAW_COUNTER_ITEM 結構包含計數器的實例名稱和原始值。 (Unicode)
PDH_RAW_LOG_RECORD PDH_RAW_LOG_RECORD結構包含二進位追蹤記錄檔記錄的相關資訊。
PDH_STATISTICS PDH_STATISTICS 結構包含原始計數器值陣列的最小值、最大值和平均值。
PDH_TIME_INFO PDH_TIME_INFO結構包含套用至效能資料取樣的時間間隔資訊。
PERF_COUNTER_BLOCK 描述記憶體區塊，其中包含物件計數器的原始效能計數器資料。
PERF_COUNTER_DATA 包含包含 結構之PERF_COUNTER_DATA區塊的相關資訊。
PERF_COUNTER_DEFINITION 描述效能計數器。
PERF_COUNTER_HEADER 包含包含 結構之PERF_COUNTER_HEADER區塊的相關資訊。
PERF_COUNTER_IDENTIFIER 包含包含 結構之PERF_COUNTER_IDENTIFIER區塊的相關資訊。
PERF_COUNTER_IDENTITY 定義取用者在查詢中加入或移除計數器時，傳送給提供者回呼的計數器。
PERF_COUNTER_INFO 定義提供者使用之計數器的相關資訊。 CTRPP 工具會根據您指定的架構自動產生此結構。
PERF_COUNTER_REG_INFO 提供效能計數器的註冊資訊。
PERF_COUNTERSET_INFO 定義提供者所使用之計數器集的相關資訊。 CTRPP 工具會根據您指定的架構自動產生此結構。
PERF_COUNTERSET_INSTANCE 定義計數器集的實例。
PERF_COUNTERSET_REG_INFO 包含包含 結構之PERF_COUNTERSET_REG_INFO區塊的相關資訊。
PERF_DATA_BLOCK 描述您查詢的效能資料區塊，例如提供者所傳回的效能物件數目，以及計算效能值時所使用的時間型值。
PERF_DATA_HEADER 提供包含 結構之PERF_DATA_HEADER區塊的相關資訊。
PERF_INSTANCE_DEFINITION 描述效能物件的實例。
PERF_INSTANCE_HEADER 提供包含 結構之PERF_INSTANCE_HEADER區塊的相關資訊。
PERF_MULTI_COUNTERS 提供包含 結構之PERF_MULTI_COUNTERS區塊的相關資訊。
PERF_MULTI_INSTANCES 提供包含 結構之PERF_MULTI_INSTANCES區塊的相關資訊。
PERF_OBJECT_TYPE 描述物件特定的效能資訊，例如物件的實例數目，以及物件所定義的計數器數目。
PERF_PROVIDER_CONTEXT 定義提供者內容資訊。
PERF_STRING_BUFFER_HEADER 提供包含 結構之PERF_STRING_BUFFER_HEADER區塊的相關資訊。
PERF_STRING_COUNTER_HEADER 指出PERF_STRING_BUFFER_HEADER區塊中包含所指定效能計數器名稱或說明字串的字串開始的位置。