Интерфейс IAMStats (control.h)

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Интерфейс IAMStats извлекает данные о производительности из диспетчера фильтров graph. Фильтры могут использовать этот интерфейс для записи данных о производительности.

Разработчики фильтров. Как и для всех интерфейсов диспетчера фильтров Graph, фильтр не должен содержать счетчик ссылок в этом интерфейсе, иначе это приведет к циклии количества ссылок. Дополнительные сведения см. в разделе IBaseFilter::JoinFilterGraph.

Наследование

Интерфейс IAMStats наследуется от интерфейса IDispatch . IAMStats также имеет следующие типы элементов:

Методы

Интерфейс IAMStats содержит следующие методы.

IAMStats::AddValue Метод AddValue записывает новое значение.
IAMStats::get_Count Метод get_Count извлекает количество статистических данных.
IAMStats::GetIndex Метод GetIndex извлекает индекс для именованной статистики или создает новую статистику.
IAMStats::GetValueByIndex Метод GetValueByIndex извлекает статистику по индексу.
IAMStats::GetValueByName Метод GetValueByName извлекает статистику по имени.
IAMStats::Reset Метод Reset сбрасывает всю статистику до нуля.

Комментарии

Каждая статистика определяется именем и индексом. Используйте метод GetIndex , чтобы найти индекс по имени. Значения всегда являются двойными типами. Следующая статистика предопределена.

Имя	Описание
RenderFile	Измеряет время, затраченное на каждый вызов IGraphBuilder::RenderFile.
ConnectDirectInternal	Измеряет время, затраченного на подключение двух фильтров.
Сборка кэша модуля сопоставления	Измеряет время, затраченного на кэширование сведений о зарегистрированных фильтрах (используемых объектом сопоставителя фильтров ).
Имя категории процесса	Измеряет время, затраченное на кэширование сведений о фильтрах в определенной категории, где CategoryName — понятное имя категории фильтра. (См . раздел Категории фильтра.)

 

Для каждой из этих статистических данных значения представляют время в миллисекундах.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	control.h (включая Dshow.h)

См. также раздел

IDispatch