Objectos (SDK de Windows Media Format 11)
[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 SDK de Windows Media Format usa varios objetos para leer, escribir, editar e indexar archivos ASF, así como para crear y editar perfiles. Cada objeto admite una serie de interfaces. Algunas interfaces se admiten en varios objetos. En estos casos, las diferencias en la implementación se describen en la sección de referencia de la interfaz.
Los objetos del SDK de Windows Media Format son compatibles con COM. Para facilitar el desarrollo, cada objeto tiene una función o método de creación asociado. Debe crear objetos mediante la función de creación o el método en lugar de usar manualmente la función COM CoCreateInstance.
Algunas interfaces tienen un número anexado a sus nombres, como IWMProfile2 e IWMWriter3. En cada caso, las versiones numeradas heredan todos los métodos de las versiones anteriores y agregan nueva funcionalidad.
En cada página de objeto de esta referencia, las interfaces incluidas en el objeto COM principal se enumeran primero, seguidas de interfaces de devolución de llamada que la aplicación debe implementar.
En la tabla siguiente se enumeran los objetos admitidos por este SDK con una descripción de la funcionalidad de cada y la función usada para crearlo.
| Object | Descripción | Función de creación |
|---|---|---|
| Restorer de copia de seguridad | Realiza una copia de seguridad de las licencias, normalmente en medios extraíbles y, a continuación, restaura esas licencias en un equipo diferente. | WMCreateBackupRestorer |
| Registro de dispositivos | Administra la base de datos de registro de dispositivos, que contiene entradas para dispositivos de reproducción multimedia que están disponibles a través de una conexión de red. | WMCreateDeviceRegistration |
| DRM Transcryptor | Convierte los datos multimedia protegidos por DRM en un flujo de datos que se puede enviar a los dispositivos que usan el protocolo DRM 10 de Windows Media para dispositivos de red. | WMCreateDRMTranscryptor |
| Indizador | Crea un índice para los archivos ASF para permitir la búsqueda en archivos con secuencias de vídeo. | WMCreateIndexer |
| Agente de revocación de licencias | Administra la revocación de licencias. | WMCreateLicenseRevocationAgent |
| Editor de metadatos | Edita los metadatos en un encabezado de archivo ASF. | WMCreateEditor |
| Administrador de perfiles | Proporciona interfaces para crear, cargar y guardar perfiles. Se requiere un perfil para escribir un archivo ASF. | WMCreateProfileManager |
| Lector | Lee los archivos ASF. Este objeto usa un modelo de llamada asincrónico para sus operaciones. | WMCreateReader |
| Lector sincrónico | Lee archivos ASF mediante llamadas sincrónicas. | WMCreateSyncReader |
| Escritor | Escribe archivos ASF. | WMCreateWriter |
| Receptor de archivos de escritura | Controla los archivos ASF escritos por el objeto writer. | WMCreateWriterFileSink |
| Receptor de red de escritor | Controla el streaming de red en vivo de los archivos ASF escritos por el objeto writer. | WMCreateWriterNetworkSink |
| Receptor de inserción de escritor | Controla la entrega del contenido de streaming a los servidores de publicación. | WMCreateWriterPushSink |
En la tabla siguiente se enumeran los objetos que dependen de otros objetos. Estos objetos se crean mediante métodos de objetos existentes.
| Object | Descripción | Método de creación |
|---|---|---|
| Uso compartido de ancho de banda | Administra la información de uso compartido de ancho de banda en un perfil. Puede existir más de un objeto de uso compartido de ancho de banda para un perfil. Hay diferentes métodos para crear un objeto de uso compartido de ancho de banda en función de si desea crear un nuevo objeto de uso compartido de ancho de banda o tener acceso a uno existente. |
IWMProfile3::CreateNewBandwidthSharingO IWMProfile3::GetBandwidthSharing |
| Buffer | Contiene un ejemplo multimedia y las extensiones de unidad de datos asociadas. Se usa para escribir y leer ejemplos. |
IWMWriter::AllocateSampleO IWMReaderAllocatorEx::AllocateForOutputEx O BIEN IWMReaderAllocatorEx::AllocateForStreamEx O BIEN Creado automáticamente por el objeto lector o el objeto de lector sincrónico para la entrega de muestras. |
| Propiedades de medios de entrada | Administra las propiedades de una entrada. Un objeto de propiedades de entrada puede existir para cada entrada. | IWMWriter::GetInputProps |
| Exclusión mutua | Administra la información de exclusión mutua en un perfil. Los usos comunes para la exclusión mutua son varios contenidos de velocidad de bits y bandas sonoras en varios idiomas. Hay diferentes métodos para crear un objeto de exclusión mutua en función de si desea crear un nuevo objeto de exclusión mutua o tener acceso a uno existente. |
IWMProfile::CreateNewMutualExclusionO IWMProfile::GetMutualExclusion |
| Propiedades de elementos multimedia de salida | Administra las propiedades de una salida. Un objeto de propiedades multimedia de salida puede existir para cada salida. El lector o el lector sincrónico pueden crear estos objetos. |
IWMReader::GetOutputPropsO IWMSyncReader::GetOutputProps |
| Perfil | Contiene los datos de un perfil mientras se manipulan. Los objetos de perfil se crean cada vez que se debe manipular el perfil. Hay diferentes métodos para crear un objeto de perfil en función de si desea crear un nuevo perfil o tener acceso a uno existente. |
IWMProfileManager::CreateEmptyProfileO IWMProfileManager::LoadProfileByData O BIEN IWMProfileManager::LoadProfileByID O BIEN IWMProfileManager::LoadSystemProfile |
| Configuración de flujo | Administra las propiedades de una secuencia dentro de un perfil. Los objetos de configuración de flujo se crean mediante objetos de secuencia cada vez que necesite acceder a la información sobre una secuencia. Hay diferentes métodos para crear un objeto de configuración de flujo en función de si desea crear una nueva secuencia o acceso y otra existente. |
IWMProfile::CreateNewStreamO IWMProfile::GetStream O BIEN IWMProfile::GetStreamByNumber |
| Priorización de flujos | Mantiene la lista de prioridad de flujo para un perfil. Las secuencias se quitarán en orden de aumentar la prioridad si el ancho de banda disponible está restringido. Solo puede haber un objeto de priorización de flujos en un perfil. | IWMProfile3::CreateNewStreamPrioritization |