Interfaces pour les applications

Cette section décrit les interfaces utilisées ou implémentées par les applications à l’aide du Kit de développement logiciel (SDK) Windows Media Device Manager pour communiquer avec les appareils. Le terme « application » utilisé ici signifie tout objet exécutable, plug-in ou COM qui existe sur un ordinateur de bureau et nécessite une communication de haut niveau avec un appareil portable connecté. Cela peut inclure une application de lecteur multimédia, un plug-in lecteur Windows Media (s’il a besoin d’un accès direct à un appareil portable) ou d’un objet COM de contrôle de nombre 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 s’il est implémenté ou appelé (et s’il est implémenté, s’il est facultatif ou obligatoire).

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

Interface ou classe	Descriptif
CSecureChannelClient, classe	Classe d’assistance qui permet aux applications de s’authentifier, de chiffrer et de déchiffrer des données, et de créer des macs.
IWMDeviceManager	Interface windows Media Device Manager 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 de l’appareil.
IWMDMDevice	Fournit des méthodes pour examiner et 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 pour les 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 dans une 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 (par exemple, 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 pour examiner et explorer un stockage (fichier, dossier, playlist) sur un appareil.
IWMDMStorage2	Étend IWMDMStorage en permettant d’obtenir un stockage enfant par 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, et pour définir et récupérer une liste de références à d’autres stockages.
IWMDMStorageControl	Utilisé pour insérer, supprimer ou déplacer des fichiers au sein 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 permettant de passer un pointeur d’interface IWMDMMetaData .
IWMDMStorageGlobals	Fournit des méthodes pour récupérer des informations globales sur un support de stockage (par exemple, une carte flash ROM) 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 pour suivre la progression d’une requête asynchrone, telle qu’une demande de lecture ou d’écriture.

Interface	Descriptif
IWMDMNotification	Permet aux applications et aux fournisseurs de services de recevoir des notifications lorsque les appareils ou les stockages mémoire (tels que les 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 pour transférer des données non chiffrées pour améliorer l’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 fichier.
IWMDMProgress2	Étend la méthode IWMDMProgress ::End en fournissant un indicateur d’état.
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 du média ou des 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 iWMDeviceManager (ces étapes sont décrites dans Authenticating the 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 marques obliques. Par conséquent, « IWMDMStorage/2/3 » indique IWMDMStorage, IWMDMStorage2 et IWMDMStorage3.

Rubriques connexes

de référence de programmation