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	Qedit.h
Biblioteca	Strmiids.lib

Consulte también

IAMTimeline (Interfaz)

Códigos de error y éxito