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 |