Interfaz IPortableDevice (portabledeviceapi.h)
La interfaz IPortableDevice proporciona acceso a un dispositivo portátil.
Para crear y abrir esta interfaz, llame primero a CoCreateInstance con CLSID_PortableDeviceFTM o CLSID_PortableDevice para recuperar una interfaz IPortableDevice y, a continuación, llame a Open para abrir una conexión con el dispositivo.
Herencia
La interfaz IPortableDevice hereda de la interfaz IUnknown . IPortableDevice también tiene estos tipos de miembros:
Métodos
La interfaz IPortableDevice tiene estos métodos.
| IPortableDevice::Advise El método Advise registra una devolución de llamada definida por la aplicación que recibe eventos de dispositivo. |
| IPortableDevice::Cancel El método Cancel cancela una operación pendiente en esta interfaz. |
| IPortableDevice::Capabilities El método Capabilities recupera una interfaz utilizada para consultar las funcionalidades de un dispositivo portátil. |
| IPortableDevice::Close El método Close cierra la conexión con el dispositivo. |
| IPortableDevice::Content El método Content recupera una interfaz que se puede usar para acceder a objetos de un dispositivo. |
| IPortableDevice::GetPnPDeviceID El método GetPnPDeviceID recupera el identificador de dispositivo Plug and Play (PnP) que la aplicación usó para abrir el dispositivo. |
| IPortableDevice::Open El método Open abre una conexión entre la aplicación y el dispositivo. |
| IPortableDevice::SendCommand El método SendCommand envía un comando al dispositivo y recupera los resultados de forma sincrónica. |
| IPortableDevice::Unadvise El método Unadvise anula el registro de un cliente de recibir notificaciones de devolución de llamada. Debe llamar a este método si llamó a Advise anteriormente. |
Comentarios
Las interfaces de cliente están diseñadas para usarse para cualquier objeto WPD; no es necesario crear una nueva instancia para cada objeto al que hace referencia la aplicación. Después de que una aplicación abra una instancia de la interfaz IPortableDevice , debe abrir y almacenar en caché cualquier otra interfaz de cliente WPD que necesite.
Para Windows 7, IPortableDevice admite dos CLSID para CoCreateInstance. CLSID_PortableDevice devuelve un puntero IPortableDevice que no agrega el serializador sin subprocesos; CLSID_PortableDeviceFTM es un nuevo CLSID que devuelve un puntero IPortableDevice que agrega el serializador de subprocesos libre. Ambos punteros admiten la misma funcionalidad de lo contrario.
Las aplicaciones que residen en apartamentos de un solo subproceso deben usar CLSID_PortableDeviceFTM , ya que esto elimina la sobrecarga de serialización de punteros de interfaz. CLSID_PortableDevice sigue siendo compatible con las aplicaciones heredadas.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | portabledeviceapi.h |