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
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 |
|
| Biblioteca |
|