Compartir a través de


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.

diagrama en el que se muestra cómo obtener las principales interfaces de aplicación en el administrador de dispositivos de Windows Media.

Referencia de programación