Interfaces para aplicaciones
En esta sección se describen las interfaces usadas o implementadas por las aplicaciones que usan el SDK de Windows Media Administrador de dispositivos para comunicarse con los dispositivos. El término "aplicación" que se usa aquí significa cualquier objeto ejecutable, complemento o COM que exista en un equipo de escritorio y necesite comunicación de alto nivel con un dispositivo portátil conectado. Esto puede incluir una aplicación de reproductor multimedia, un complemento de Reproductor multimedia de Windows (si necesita acceso directo a un dispositivo portátil) o un objeto COM de medición de recuento de reproducción.
La aplicación implementa algunas de estas interfaces, mientras que la aplicación llama a otras. La documentación de cada interfaz indica si se implementa o se llama (y si se implementa, ya sea opcional o necesario).
Las aplicaciones usan las siguientes interfaces o clases.
| Interfaz o clase | Descripción |
|---|---|
| CSecureChannelClient (clase) | Clase auxiliar que permite que las aplicaciones se autentiquen, cifren y descifren datos y creen MAC. |
| IWMDeviceManager | Interfaz de windows Media Administrador de dispositivos de nivel superior para aplicaciones. |
| IWMDeviceManager2 | Extiende IWMDeviceManager proporcionando métodos de enumeración avanzados y otros métodos. |
| IWMDeviceManager3 | Extiende la interfaz IWMDeviceManager2 proporcionando un método que establece la preferencia de enumeración del dispositivo. |
| IWMDMDevice | Proporciona métodos para examinar y explorar un único dispositivo portátil. |
| IWMDMDevice2 | Extiende IWMDMDevice haciendo posible obtener los formatos de vídeo admitidos por un dispositivo, buscar un almacenamiento por nombre y usar páginas de propiedades. |
| IWMDMDevice3 | Extiende IWMDMDevice2 proporcionando métodos para consultar un dispositivo para obtener propiedades, enviar códigos de control de E/S de dispositivo y también proporcionar métodos actualizados para buscar almacenamientos y recuperar funcionalidades de formato de dispositivo. |
| IWMDMDeviceControl | Proporciona métodos para controlar dispositivos. |
| IWMDMDeviceSession | Mejora la eficacia de las operaciones del dispositivo agrupando varias operaciones en una sesión |
| IWMDMEnumDevice | Enumera los dispositivos portátiles conectados a un equipo. |
| IWMDMEnumStorage | Enumera los almacenamientos de un dispositivo. |
| IWMDMMetaData | Establece y recupera propiedades de metadatos (como artista, álbum, género, etc.) de un almacenamiento. |
| IWMDMObjectInfo | Obtiene y establece información que controla cómo controlan los archivos reproducibles en el dispositivo la interfaz IWMDMDeviceControl . |
| IWMDMRevoked | Recupera la dirección URL desde la que se pueden descargar los componentes actualizados, si se produce un error de revocación en una transferencia. |
| IWMDMStorage | Proporciona métodos para examinar y explorar un almacenamiento (archivo, carpeta, lista de reproducción) en un dispositivo. |
| IWMDMStorage2 | Extiende IWMDMStorage haciendo posible obtener un almacenamiento secundario por nombre y para obtener y establecer atributos extendidos. |
| IWMDMStorage3 | Extiende IWMDMStorage2 mediante la exposición de metadatos. |
| IWMDMStorage4 | Extiende IWMDMStorage3 proporcionando métodos para recuperar un subconjunto de metadatos disponibles para un almacenamiento y para establecer y recuperar una lista de referencias a otros almacenamientos. |
| IWMDMStorageControl | Se usa para insertar, eliminar o mover archivos dentro de un dispositivo, o entre un dispositivo y el equipo. |
| IWMDMStorageControl2 | Extiende IWMDMStorageControl al permitir establecer el nombre del archivo de destino al insertar contenido en un almacenamiento. |
| IWMDMStorageControl3 | Extiende IWMDMStorageControl2 haciendo posible pasar un puntero de interfaz IWMDMMetaData . |
| IWMDMStorageGlobals | Proporciona métodos para recuperar información global sobre un medio de almacenamiento (como una tarjeta ROM flash) en un dispositivo. |
| IWMDRMDeviceApp | Permite que una aplicación realice la medición, la sincronización de licencias y la actualización de los componentes DRM de un dispositivo. |
| IWMDRMDeviceApp2 | Extiende IWMDRMDeviceApp proporcionando una nueva versión del método QueryDeviceStatus . |
Interfaces de devolución de llamada
Una aplicación implementa las siguientes interfaces opcionales para realizar un seguimiento del progreso de una solicitud asincrónica, como una solicitud de lectura o escritura.
| Interfaz | Descripción |
|---|---|
| IWMDMNotification | Permite que las aplicaciones y los proveedores de servicios reciban notificaciones cuando los dispositivos o los almacenamientos de memoria (como las tarjetas RAM) estén conectados o desconectados del equipo. |
| IWMDMOperation2 | Extiende IWMDMOperation proporcionando métodos para obtener y establecer atributos extendidos. |
| IWMDMOperation3 | Extiende IWMDMOperation proporcionando un nuevo método para transferir datos sin cifrar para aumentar la eficacia. |
| IWMDMOperation | Permite a una aplicación controlar cómo se leen o escriben los datos en el equipo durante una transferencia de archivos. |
| IWMDMProgress2 | Extiende el método IWMDMProgress::End proporcionando un indicador de estado. |
| IWMDMProgress3 | Extiende IWMDMProgress2 proporcionando parámetros de entrada adicionales para especificar el identificador de evento y la información específica del contexto. |
| IWMDMProgress | Permite a una aplicación realizar un seguimiento del progreso de las operaciones, como dar formato a medios o transferencias de archivos. |
En el diagrama siguiente se muestra cómo se adquiere la mayor parte de las interfaces de aplicación importantes de la interfaz IWMDeviceManager raíz. Una aplicación obtiene esta interfaz raíz mediante la cocreación del objeto MediaDevMgr, solicitando la interfaz IComponentAuthenticate , autenticando el componente y solicitando el IWMDeviceManager (estos pasos se describen en Autenticación de la aplicación). Una vez adquirida esta interfaz raíz, se llama a IWMDeviceManager::EnumDevices para crear un objeto que implemente IWMDMEnumDevice. Otras interfaces se obtienen llamando a métodos en interfaces en el orden mostrado. Las interfaces derivadas, como IWMDMDevice2 , se obtienen llamando a QueryInterface en la interfaz base.
En el diagrama siguiente, las interfaces derivadas se etiquetan mediante marcas de barra diagonal, por lo que "IWMDMStorage/2/3" indicaría IWMDMStorage, IWMDMStorage2 e IWMDMStorage3.
Temas relacionados