Метод IRenderEngine::SetSourceNameValidation
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Примечание
[Не рекомендуется. Этот API можно удалить из будущих выпусков Windows.]
Метод SetSourceNameValidation указывает, как модуль отрисовки проверяет имена файлов.
Синтаксис
HRESULT SetSourceNameValidation(
BSTR FilterString,
IMediaLocator *pOverride,
LONG Flags
);
Параметры
-
FilterString
-
Значение BSTR , содержащее пары строк фильтра, отформатированных в соответствии с требованиями элемента lpstrFilter структуры OPENFILENAME . Указатель мультимедиа использует этот фильтр, если он представляет пользователю диалоговое окно Открытие файла.
-
pOverride
-
Необязательный указатель на интерфейс IMediaLocator указателя мультимедиа для использования вместо стандартного. Чтобы использовать указатель мультимедиа по умолчанию, задайте для этого параметра значение NULL. Дополнительные сведения см. в разделе "Примечания".
-
Flags
-
Побитовое сочетание флагов проверки имени файла , указывающее поведение указателя мультимедиа. Должен присутствовать флаг SFN_VALIDATEF_CHECK. Флаг SFN_VALIDATEF_hlinkMUTED не влияет на этот метод.
Возвращаемое значение
Возвращает одно из следующих значений HRESULT :
| Код возврата | Описание |
|---|---|
|
Успешно. |
|
Не удалось инициализировать подсистему отрисовки. |
Комментарии
С помощью параметра pOverride можно предоставить собственную пользовательскую реализацию интерфейса IMediaLocator . Например, указатель мультимедиа по умолчанию не уведомляет приложение о файлах, которые оно находит (или не может найти). Чтобы обойти это ограничение, можно реализовать пользовательский указатель мультимедиа, сделав его оболочкой для версии по умолчанию. Затем передайте вызовы IMediaLocator::FindMediaFile непосредственно в версию по умолчанию и проверьте возвращаемое значение.
В настоящее время этот метод не проверяет динамически загруженные источники. См. раздел IRenderEngine::SetDynamicReconnectLevel.
Примечание
Файл заголовка 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).
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел