Čítače procházení

Chcete-li zobrazit dialogové okno se seznamem objektů výkonu a čítačů definovaných na tomto počítači, zavolejte funkci PdhBrowseCounters. Dialogové okno umožňuje uživateli procházet a vybírat čítače výkonu. Pomocí struktury PDH_BROWSE_DLG_CONFIG určíte konfiguraci dialogového okna. Můžete například nakonfigurovat dialogové okno tak, aby vrátilo jeden výběr nebo více výběrů.

Při zadání szReturnPathBuffer má member výchozí objekt výkonu a čítač, které jsou vybrány v dialogovém okně. Na výstupu vyrovnávací paměť obsahuje objekt výkonu a čítač, který uživatel vybral. Můžete také použít člena pCallBack k zadání funkce zpětného volání pro zpracování názvů čítačů, které vrací dialogové okno.

Všimněte si, že toto dialogové okno může vrátit PDH_DIALOG_CANCELLED, pokud bSingleCounterPerDialog je FALSE a uživatel klikne na tlačítko Zavřít, takže by vaše zpracování chyb muselo tuto možnost zohlednit.

Příklad, který používá funkci PdhBrowseCounters, viz Procházení čítačů výkonu.

Pokud chcete načíst seznam objektů výkonu v počítači, můžete také volat funkci PdhEnumObjects. Chcete-li načíst seznam čítačů a instancí pro objekt výkonu, zavolejte funkci PdhEnumObjectItems. Tyto funkce můžete použít také k identifikaci objektů výkonu a čítačů obsažených v souboru protokolu. Opakované volání PdhEnumObjectItems vrátí stejný seznam čítačů a instancí, dokud nejprve neprovedete volání PdhEnumObjects k obnovení seznamu výkonových objektů. Příklad výčtu objektů a čítačů naleznete v tématu Výčet objektů procesu.

Výběr zdroje dat

Pomocí PdhSelectDataSource ve spojení s PdhBrowseCounters můžete uživatele vyzvat, aby zvolil, zda je zdroj dat v reálném čase nebo ze souboru protokolu, a pokud se jedná o soubor protokolu, zadat jeho název. Pokud nechcete, aby se zobrazovalo dialogové okno zdroje dat, můžete použít PdhSelectDataSource, abyste zobrazili pouze katalog prohlížeče souborů. Chcete-li to provést, jako druhý parametr volání zadejte PDH_FLAGS_FILE_BROWSER_ONLY pro PdhSelectDataSource.