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.

Rubriques connexes

Guide de référence de programmation