Partager via


Interfaces pour les applications

Cette section décrit les interfaces utilisées ou implémentées par les applications qui utilisent le Kit de développement logiciel (SDK) Windows Media Gestionnaire de périphériques pour communiquer avec les appareils. Le terme « application » utilisé ici désigne tout objet exécutable, plug-in ou COM existant sur un ordinateur de bureau et nécessitant une communication de haut niveau avec un appareil portable connecté. Il peut s’agir d’une application de lecteur multimédia, d’un plug-in Lecteur multimédia Windows (s’il a besoin d’un accès direct à un appareil portable) ou d’un objet COM de comptage de lecture.

Certaines de ces interfaces sont implémentées par l’application, tandis que d’autres sont appelées par l’application. La documentation de chaque interface indique si elle est implémentée ou appelée (et si implémentée, si elle est facultative ou obligatoire).

Les interfaces ou classes suivantes sont utilisées par les applications.

Interface ou classe Description
Classe CSecureChannelClient Classe d’assistance qui permet aux applications de s’authentifier, de chiffrer et de déchiffrer des données, et de créer des contrôleurs de contrôle d’accès.
IWMDeviceManager Interface Windows Media Gestionnaire de périphériques de niveau supérieur pour les applications.
IWMDeviceManager2 Étend IWMDeviceManager en fournissant des méthodes d’énumération avancées et d’autres méthodes.
IWMDeviceManager3 Étend l’interface IWMDeviceManager2 en fournissant une méthode qui définit la préférence d’énumération d’appareil.
IWMDMDevice Fournit des méthodes permettant d’examiner et d’explorer un seul appareil portable.
IWMDMDevice2 Étend IWMDMDevice en permettant d’obtenir les formats vidéo pris en charge par un appareil, de rechercher un stockage par nom et d’utiliser des pages de propriétés.
IWMDMDevice3 Étend IWMDMDevice2 en fournissant des méthodes permettant d’interroger un appareil à la recherche de propriétés, d’envoyer des codes de contrôle d’E/S d’appareil et de fournir également des méthodes mises à niveau pour rechercher des stockages et récupérer des fonctionnalités de format d’appareil.
IWMDMDeviceControl Fournit des méthodes pour contrôler les appareils.
IWMDMDeviceSession Améliore l’efficacité des opérations d’appareil en regroupant plusieurs opérations en une seule session
IWMDMEnumDevice Énumère les appareils portables attachés à un ordinateur.
IWMDMEnumStorage Énumère les stockages sur un appareil.
IWMDMMetaData Définit et récupère les propriétés de métadonnées (telles que l’artiste, l’album, le genre, etc.) d’un stockage.
IWMDMObjectInfo Obtient et définit des informations qui contrôlent la façon dont les fichiers lisibles sur l’appareil sont gérés par l’interface IWMDMDeviceControl
IWMDMRevoked Récupère l’URL à partir de laquelle les composants mis à jour peuvent être téléchargés, si un transfert échoue avec une erreur de révocation.
IWMDMStorage Fournit des méthodes permettant d’examiner et d’explorer un stockage (fichier, dossier, playlist) sur un appareil.
IWMDMStorage2 Étend IWMDMStorage en permettant d’obtenir un stockage enfant par son nom et d’obtenir et de définir des attributs étendus.
IWMDMStorage3 Étend IWMDMStorage2 en exposant les métadonnées.
IWMDMStorage4 Étend IWMDMStorage3 en fournissant des méthodes pour récupérer un sous-ensemble de métadonnées disponibles pour un stockage, ainsi que pour définir et récupérer une liste de références à d’autres stockages.
IWMDMStorageControl Permet d’insérer, de supprimer ou de déplacer des fichiers à l’intérieur d’un appareil ou entre un appareil et l’ordinateur.
IWMDMStorageControl2 Étend IWMDMStorageControl en permettant de définir le nom du fichier de destination lors de l’insertion de contenu dans un stockage.
IWMDMStorageControl3 Étend IWMDMStorageControl2 en rendant possible le passage d’un pointeur d’interface IWMDMMetaData .
IWMDMStorageGlobals Fournit des méthodes permettant de récupérer des informations globales sur un support de stockage (par exemple, une carte de rom flash) sur un appareil.
IWMDRMDeviceApp Permet à une application d’effectuer le contrôle, la synchronisation des licences et la mise à jour des composants DRM d’un appareil.
IWMDRMDeviceApp2 Étend IWMDRMDeviceApp en fournissant une nouvelle version de la méthode QueryDeviceStatus .

 

Interfaces de rappel

Les interfaces facultatives suivantes sont implémentées par une application afin de suivre la progression d’une requête asynchrone, telle qu’une demande en lecture ou en écriture.

Interface Description
IWMDMNotification Permet aux applications et aux fournisseurs de services de recevoir des notifications lorsque des appareils ou des stockages de mémoire (tels que des cartes RAM) sont connectés ou déconnectés de l’ordinateur.
IWMDMOperation2 Étend IWMDMOperation en fournissant des méthodes pour obtenir et définir des attributs étendus.
IWMDMOperation3 Étend IWMDMOperation en fournissant une nouvelle méthode de transfert des données non chiffrées pour plus d’efficacité.
IWMDMOperation Permet à une application de contrôler la façon dont les données sont lues ou écrites sur l’ordinateur pendant un transfert de fichiers.
IWMDMProgress2 Étend la méthode IWMDMProgress::End en fournissant un indicateur status.
IWMDMProgress3 Étend IWMDMProgress2 en fournissant des paramètres d’entrée supplémentaires pour spécifier l’ID d’événement et les informations spécifiques au contexte.
IWMDMProgress Permet à une application de suivre la progression des opérations, telles que la mise en forme de supports ou de transferts de fichiers.

 

Le diagramme suivant montre comment la plupart des interfaces d’application importantes sont acquises à partir de l’interface IWMDeviceManager racine. Une application obtient cette interface racine en cocréant l’objet MediaDevMgr, en demandant l’interface IComponentAuthenticate , en authentifiant le composant, puis en demandant l’IWMDeviceManager (ces étapes sont décrites dans Authentification de l’application). Une fois cette interface racine acquise, IWMDeviceManager::EnumDevices est appelé pour créer un objet qui implémente IWMDMEnumDevice. D’autres interfaces sont obtenues en appelant des méthodes sur des interfaces dans l’ordre indiqué. Les interfaces dérivées telles que IWMDMDevice2 sont obtenues en appelant QueryInterface sur l’interface de base.

Dans le diagramme suivant, les interfaces dérivées sont étiquetées par des barres obliques. Par conséquent, « IWMDMStorage/2/3 » indique IWMDMStorage, IWMDMStorage2 et IWMDMStorage3.

diagramme montrant comment obtenir les principales interfaces d’application dans Windows Media Device Manager.

Guide de référence de programmation