Método IRenderEngine::SetSourceNameValidation
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
Nota:
[Desusado. Esta API se puede quitar de futuras versiones de Windows.
El SetSourceNameValidation método especifica cómo el motor de representación valida los nombres de archivo.
Sintaxis
HRESULT SetSourceNameValidation(
BSTR FilterString,
IMediaLocator *pOverride,
LONG Flags
);
Parámetros
-
FilterString
-
Valor BSTR que contiene pares de cadenas de filtro, con el formato requerido por el miembro lpstrFilter de la estructura OPENFILENAME . El localizador multimedia usa este filtro si presenta un cuadro de diálogo Abrir archivo al usuario final.
-
pOverride
-
Puntero opcional a la interfaz IMediaLocator de un localizador multimedia que se usará en lugar del valor predeterminado. Para usar el localizador de medios predeterminado, establezca el valor de este parámetro en NULL. Vea Comentarios para obtener más información.
-
Marcas
-
Combinación bit a bit de marcas de validación de nombres de archivo que especifican el comportamiento del localizador multimedia. La marca SFN_VALIDATEF_CHECK debe estar presente. La marca SFN_VALIDATEF_hlinkMUTED no tiene ningún efecto con este método.
Valor devuelto
Devuelve uno de los siguientes valores HRESULT :
| Código devuelto | Descripción |
|---|---|
|
Correcto. |
|
No se pudo inicializar el motor de representación. |
Observaciones
Con el parámetro pOverride , puede proporcionar su propia implementación personalizada de la interfaz IMediaLocator . Por ejemplo, el localizador de medios predeterminado no notifica a una aplicación los archivos que encuentra (o no se encuentra). Para evitar esta limitación, podría implementar un localizador de medios personalizado, lo que lo convierte en un contenedor para la versión predeterminada. A continuación, pase IMediaLocator::FindMediaFile llama directamente a la versión predeterminada y examine el valor devuelto.
Actualmente, este método no valida los orígenes cargados dinámicamente. Consulte IRenderEngine::SetDynamicReconnectLevel.
Nota:
El archivo de encabezado Qedit.h no es compatible con los encabezados de Direct3D posteriores a la versión 7.
Nota:
Para obtener Qedit.h, descargue la actualización de Microsoft Windows SDK para Windows Vista y .NET Framework 3.0. Qedit.h no está disponible en el Microsoft Windows SDK para Windows 7 y .NET Framework 3.5 Service Pack 1.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|
Consulte también