Интерфейс IMediaLocator
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]
Примечание
[Не рекомендуется. Этот API может быть удален из будущих выпусков Windows.]
Интерфейс IMediaLocator предоставляет методы для проверки имен файлов в службах редактирования DirectShow (DES). Используйте этот интерфейс, чтобы убедиться, что заданное имя файла и путь соответствуют существующему файлу. Этот интерфейс также предоставляет способ поиска файла в других расположениях и отображения диалогового окна Открыть , чтобы пользователь мог найти файл.
Указатель мультимедиа реализует этот интерфейс. Временная шкала и обработчик отрисовки также поддерживают проверку имени файла с помощью следующих методов:
- IAMTimeline::ValidateSourceNames: проверяет и обновляет имена файлов в временная шкала.
- IRenderEngine::SetSourceNameValidation: указывает, как обработчик отрисовки проверяет имена файлов во время отрисовки.
Как правило, приложение 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).
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по