Счетчики навигации

Чтобы отобразить диалоговое окно со списком объектов производительности и счетчиков, определенных на компьютере, вызовите функцию PdhBrowseCounters. Диалоговое окно позволяет пользователю просматривать и выбирать счетчики производительности. Структура PDH_BROWSE_DLG_CONFIG используется для указания конфигурации диалогового окна. Например, можно настроить диалоговое окно для возврата одного выбора или нескольких выборок.

На входе элемент szReturnPathBuffer содержит объект производительности по умолчанию и счетчик, выбранный в диалоговом окне. В выходных данных буфер содержит объект производительности и счетчик, выбранный пользователем. Можно также использовать элемент pCallBack, чтобы указать функцию обратного вызова для обработки имен счетчиков, возвращаемых диалоговым окном.

Обратите внимание, что это диалоговое окно может возвращать PDH_DIALOG_CANCELLED, если bSingleCounterPerDialogfalse, а пользователь нажимает кнопку "Закрыть", поэтому обработка ошибок потребуется учесть это.

Пример использования функции PdhBrowseCounters см. в разделе Просмотр счетчиков производительности.

Чтобы получить список объектов производительности на компьютере, можно также вызвать функцию PdhEnumObjects. Чтобы получить список счетчиков и экземпляров для объекта производительности, вызовите функцию PdhEnumObjectItems. Эти функции также можно использовать для идентификации объектов производительности и счетчиков, содержащихся в файле журнала. Повторяющиеся вызовы PdhEnumObjectItems возвращают тот же список счетчиков и экземпляров, пока не вызовете PdhEnumObjects, чтобы сначала обновить список объектов производительности. Пример перечисления объектов и счетчиков см. в разделе Перечисление объектов процесса.

Выбор источника данных

Вы можете использовать PdhSelectDataSource в сочетании с PdhBrowseCounters, чтобы предложить пользователю выбрать, находится ли источник данных в режиме реального времени или из файла журнала, а если это файл журнала, его имя. Если вы не хотите отображать диалоговое окно источника данных, можно вызвать PdhSelectDataSource, чтобы отобразить только каталог браузера файлов. Для этого укажите PDH_FLAGS_FILE_BROWSER_ONLY в качестве второго параметра при вызове PdhSelectDataSource.