Интерфейс IAMOpenProgress (strmif.h)

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

Интерфейс IAMOpenProgress сообщает о ходе операции открытия файла и позволяет приложению отменить операцию.

Фильтры, открывающие файлы по сети, могут предоставлять этот интерфейс. Приложение может использовать его для запроса хода скачивания или отмены скачивания. Если сеть не реагирует, такой метод, как IGraphBuilder::RenderFile , может блокироваться на неопределенный период. Чтобы предотвратить блокировку приложения, создайте рабочий поток, который использует IAMOpenProgress для отслеживания хода выполнения. Рабочий поток может отменить операцию, если наступает предопределенное время ожидания или в ответ на команду от пользователя.

Фильтр источника файлов (URL-адрес) поддерживает этот интерфейс.

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

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

Методы

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

IAMOpenProgress::AbortOperation Метод AbortOperation отменяет операцию открытия файла.
IAMOpenProgress::QueryProgress Метод QueryProgress извлекает ход выполнения операции открытия файла.

Требования

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