Interfaz IMediaLocator

[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.

 

La IMediaLocator interfaz proporciona métodos para validar nombres de archivo en DirectShow Editing Services (DES). Use esta interfaz para asegurarse de que un nombre de archivo y una ruta de acceso especificados corresponden a un archivo existente. Esta interfaz también proporciona una manera de buscar el archivo en otras ubicaciones y mostrar un cuadro de diálogo Abrir para que el usuario pueda localizar el archivo.

El localizador de medios implementa esta interfaz. La escala de tiempo y el motor de representación también admiten la validación de nombres de archivo mediante los métodos siguientes:

• IAMTimeline::ValidateSourceNames: valida y actualiza los nombres de archivo en la escala de tiempo.
• IRenderEngine::SetSourceNameValidation: especifica cómo el motor de representación valida los nombres de archivo en tiempo de representación.

Normalmente, una aplicación DES llamará a estos métodos en lugar de crear directamente una instancia del localizador multimedia. Para obtener más información, consulte Uso del localizador de medios.

Miembros

La interfaz IMediaLocator hereda de la interfaz IUnknown . IMediaLocator también tiene estos tipos de miembros:

• Métodos

Métodos

La interfaz IMediaLocator tiene estos métodos.

Método	Descripción
AddFoundLocation	Agrega un directorio a la caché de directorios.
FindMediaFile	Busca un archivo y, si se ejecuta correctamente, recupera la ruta de acceso al archivo.

 

Observaciones

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