Método IAMTimeline::ValidateSourceNames
[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 ValidateSourceNames método valida los nombres de origen en la escala de tiempo mediante el localizador de medios. Opcionalmente, este método también actualiza cualquier objeto de origen para el que busque un archivo.
Sintaxis
HRESULT ValidateSourceNames(
long ValidateFlags,
IMediaLocator *pOverride,
long NotifyEventHandle
);
Parámetros
-
ValidateFlags
-
Combinación bit a bit de marcas de validación de nombres de archivo que especifican el comportamiento del localizador multimedia. Las marcas SFN_VALIDATEF_REPLACE y SFN_VALIDATEF_CHECK deben estar presentes o el método devuelve E_INVALIDARG.
-
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.
-
NotifyEventHandle
-
Identificador para un evento. El método indica el evento después de que haya completado la validación.
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
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 notificará a la 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. En la versión personalizada, pase IMediaLocator::FindMediaFile llama directamente a la versión predeterminada y examine el valor devuelto.
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