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 del Administrador de dispositivos de Windows Media para comunicarse con 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 del reproductor multimedia, un complemento del Reproductor de Windows Media (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 obligatorio).

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 Device Manager 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 las propiedades, enviar códigos de control de E/S de dispositivo y 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 de dispositivo mediante la agrupación de varias operaciones en una sesión
IWMDMEnumDevice Enumera los dispositivos portátiles conectados a un equipo.
IWMDMEnumStorage Enumera los almacenamientos en 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 se controlan los archivos reproducibles en el dispositivo mediante 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 de una transferencia.
IWMDMStorage Proporciona métodos para examinar y explorar un almacenamiento (archivo, carpeta, lista de reproducción) en un dispositivo.
IWMDMStorage2 Extiende IWMDMStorage , ya que permite obtener un almacenamiento secundario por nombre y obtener y establecer atributos extendidos.
IWMDMStorage3 Extiende IWMDMStorage2 exponiendo 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 , ya que permite establecer el nombre del archivo de destino al insertar contenido en un almacenamiento.
IWMDMStorageControl3 Extiende IWMDMStorageControl2 , lo que permite 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 lograr una mayor 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 adquieren la mayoría 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 barras diagonales, por lo que "IWMDMStorage/2/3" indicaría IWMDMStorage, IWMDMStorage2 e IWMDMStorage3.

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

de referencia de programación de