Поделиться через

Интерфейс IMediaLocator

  • Статья

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

Примечание

[Не рекомендуется. Этот API может быть удален из будущих выпусков Windows.]

 

Интерфейс IMediaLocator предоставляет методы для проверки имен файлов в службах редактирования DirectShow (DES). Используйте этот интерфейс, чтобы убедиться, что заданное имя файла и путь соответствуют существующему файлу. Этот интерфейс также предоставляет способ поиска файла в других расположениях и отображения диалогового окна Открыть , чтобы пользователь мог найти файл.

Указатель мультимедиа реализует этот интерфейс. Временная шкала и обработчик отрисовки также поддерживают проверку имени файла с помощью следующих методов:

Как правило, приложение DES вызывает эти методы, а не создает экземпляр указателя мультимедиа напрямую. Дополнительные сведения см. в разделе Использование указателя мультимедиа.

Элементы

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

Методы

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

Метод Описание
AddFoundLocation Добавляет каталог в кэш каталогов.
FindMediaFile Выполняет поиск файла и в случае успешного выполнения извлекает путь к файлу.

 

Комментарии

Примечание

Файл заголовка Qedit.h несовместим с заголовками Direct3D более поздней версии 7.

 

Примечание

Чтобы получить Qedit.h, скачайте обновление Microsoft Windows SDK для Windows Vista и платформа .NET Framework 3.0. Qedit.h недоступен в Microsoft Windows SDK для Windows 7 и платформа .NET Framework 3.5 с пакетом обновления 1 (SP1).

 

Требования

Требование Значение
Заголовок
Qedit.h
Библиотека
Strmiids.lib