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