Objeto del lector
[La característica asociada a esta página, WINDOWS Media Format 11 SDK, es una característica heredada. Se ha reemplazado por lector de origen y escritor receptor. Lector de origen y escritor receptor se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use lector fuente y escritor receptor en lugar del SDK de Windows Media Format 11, 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.
El objeto lector lee ejemplos de datos de archivos multimedia. El objeto lector admite actualmente archivos que usan la estructura de archivos de formato de sistemas avanzados (ASF), así como archivos MP3. Los datos entregados por el objeto lector están sin comprimir y listos para la representación de forma predeterminada, aunque los ejemplos se pueden entregar sin descomprimirse si lo desea. Las muestras se entregan de forma asincrónica desde el objeto lector; debe configurar una función de devolución de llamada para recibirlas. Para la reproducción sincrónica de archivos ASF, use el objeto de lector sincrónico. Ni el lector ni el lector sincrónico representan ningún dato. Debe proporcionar sus propias rutinas de representación para mostrar los medios recuperados de un archivo.
Cuando un archivo contiene medios codificados que se pueden descodificar con un códec admitido por el objeto lector, puede controlar el formato de la salida sin comprimir. Para cambiar el formato de salida descomprimida de una secuencia, debe recuperar el objeto de propiedades multimedia de salida predeterminado para esa secuencia, realizar cambios en él y reasignarlo a la secuencia en el lector. Los objetos de propiedades multimedia de salida están subordinados al objeto lector y solo se deben crear mediante el método IWMReader::GetOutputProps .
La función WMCreateReader crea el objeto reader, que establece un puntero a una interfaz IWMReader . Las demás interfaces del objeto lector se pueden obtener llamando al método QueryInterface .
El objeto lector admite las interfaces siguientes.
| Interfaz | Descripción |
|---|---|
| IReferenceClock | Proporciona acceso al reloj del sistema utilizado por el lector. |
| IWMDRMReader | Administra la adquisición de licencias, las propiedades drm y la individualización del cliente. |
| IWMDRMReader2 | Proporciona acceso a licencias que usan niveles de protección de salida (OPL) para especificar derechos. |
| IWMHeaderInfo | Establece y recupera información de encabezado, incluidos metadatos, marcadores y datos de script. |
| IWMHeaderInfo2 | Recupera información sobre los códecs que se usaron para codificar el contenido en el archivo. Hereda todos los métodos de IWMHeaderInfo. |
| IWMHeaderInfo3 | Admite tamaños de atributo grandes, nombres de atributos duplicados y compatibilidad con varios idiomas. Hereda todos los métodos de IWMHeaderInfo e IWMHeaderInfo2. |
| IWMPacketSize | Recupera el tamaño del paquete más grande del archivo cargado en el lector. |
| IWMPacketSize2 | Recupera el tamaño del paquete más pequeño del archivo cargado en el lector. |
| IWMProfile | Proporciona acceso a la información de perfil del archivo cargado en el lector. |
| IWMProfile2 | Recupera el identificador único global (GUID), si existe, asociado al perfil. Hereda todos los métodos de IWMProfile. |
| IWMProfile3 | Admite el uso compartido de ancho de banda y la información de priorización de flujos en el perfil. Hereda todos los métodos de IWMProfile e IWMProfile2. |
| IWMReader | Proporciona funcionalidades básicas de lectura de archivos, incluidas operaciones como abrir, cerrar, iniciar, pausar, reanudar, detener y obtener y establecer las propiedades de salida. |
| IWMReaderAccelerator | Se comunica con la aceleración de vídeo de DirectX. |
| IWMReaderAdvanced | Proporciona características avanzadas del lector, como un reloj proporcionado por el usuario, la asignación de búferes, las estadísticas de devolución y las notificaciones de selección de secuencias. |
| IWMReaderAdvanced2 | Proporciona un intervalo adicional de métodos avanzados para un objeto lector existente. Hereda todos los métodos de IWMReaderAdvanced. |
| IWMReaderAdvanced3 | Proporciona un control avanzado de búsqueda y streaming. Hereda todos los métodos de IWMReaderAdvanced e IWMReaderAdvanced2. |
| IWMReaderAdvanced4 | Proporciona opciones avanzadas de lector, incluida la compatibilidad con varios idiomas. Hereda todos los métodos de IWMReaderAdvanced, IWMReaderAdvanced2 e IWMReaderAdvanced3. |
| IWMReaderNetworkConfig | Controla las opciones de configuración de red. |
| IWMReaderNetworkConfig2 | Proporciona acceso a opciones avanzadas de configuración de red. Hereda todos los métodos de IWMReaderNetworkConfig. |
| IWMReaderStreamClock | Establece y cancela temporizadores en los relojes de secuencia y recupera el valor actual de un reloj de secuencia especificado. |
| IWMReaderTimecode | Proporciona información sobre los intervalos de código de tiempo SMPTE en el archivo cargado en el lector. |
| IWMReaderTypeNegotiation | Comprueba si los cambios en las propiedades de salida de una secuencia funcionan correctamente. |
Las siguientes interfaces de devolución de llamada se pueden implementar en la aplicación para realizar un seguimiento del progreso de un objeto lector.
| Interfaz | Descripción |
|---|---|
| IWMCredentialCallback | Adquiere las credenciales de los usuarios y comprueba que tienen permiso para acceder a un sitio remoto. |
| IWMReaderAllocatorEx | Proporciona alternativas expandidas a los métodos AllocateForOutput y AllocateForStream de la interfaz IWMReaderCallbackAdvanced . |
| IWMReaderCallback | Proporciona métodos de devolución de llamada para los métodos Start y Open de IWMReader. |
| IWMReaderCallbackAdvanced | Proporciona métodos de devolución de llamada para los métodos de la interfaz IWMReaderAdvanced . |
| IWMStatusCallback | Se requiere cuando se debe comunicar la información de estado a la aplicación host. |
Temas relacionados