Partager via


Interface IPortableDevice (portabledeviceapi.h)

L’interface IPortableDevice permet d’accéder à un appareil portable.

Pour créer et ouvrir cette interface, appelez d’abord CoCreateInstance avec CLSID_PortableDeviceFTM ou CLSID_PortableDevice pour récupérer une interface IPortableDevice , puis appelez Open pour ouvrir une connexion à l’appareil.

Héritage

L’interface IPortableDevice hérite de l’interface IUnknown. IPortableDevice possède également les types de membres suivants :

Méthodes

L’interface IPortableDevice possède ces méthodes.

 
IPortableDevice::Advise

La méthode Advise inscrit un rappel défini par l’application qui reçoit des événements d’appareil.
IPortableDevice::Cancel

La méthode Cancel annule une opération en attente sur cette interface.
IPortableDevice::Capabilities

La méthode Capabilities récupère une interface utilisée pour interroger les fonctionnalités d’un appareil portable.
IPortableDevice::Close

La méthode Close ferme la connexion avec l’appareil.
IPortableDevice::Content

La méthode Content récupère une interface que vous pouvez utiliser pour accéder aux objets sur un appareil.
IPortableDevice::GetPnPDeviceID

La méthode GetPnPDeviceID récupère l’identificateur d’appareil Plug-and-Play (PnP) utilisé par l’application pour ouvrir l’appareil.
IPortableDevice::Open

La méthode Open ouvre une connexion entre l’application et l’appareil.
IPortableDevice::SendCommand

La méthode SendCommand envoie une commande à l’appareil et récupère les résultats de manière synchrone.
IPortableDevice::Unadvise

La méthode Unadvise empêche un client de recevoir des notifications de rappel. Vous devez appeler cette méthode si vous avez appelé Conseiller précédemment.

Notes

Les interfaces clientes sont conçues pour être utilisées pour n’importe quel objet WPD ; il n’est pas nécessaire de créer un instance pour chaque objet référencé par l’application. Une fois qu’une application a ouvert une instance de l’interface IPortableDevice, elle doit ouvrir et mettre en cache toutes les autres interfaces clientES WPD dont elle aura besoin.

Pour Windows 7, IPortableDevice prend en charge deux CLSID pour CoCreateInstance. CLSID_PortableDevice retourne un pointeur IPortableDevice qui n’agrége pas le marshaler à thread libre ; CLSID_PortableDeviceFTM est un nouveau CLSID qui retourne un pointeur IPortableDevice qui agrège le marshaler à thread libre. Sinon, les deux pointeurs prennent en charge les mêmes fonctionnalités.

Les applications qui vivent dans les appartements à thread unique doivent utiliser CLSID_PortableDeviceFTM car cela élimine la surcharge liée au marshaling des pointeurs d’interface. CLSID_PortableDevice est toujours pris en charge pour les applications héritées.

Configuration requise

   
Plateforme cible Windows
En-tête portabledeviceapi.h

Voir aussi

Interfaces clientes