IPortableDevice 接口 (portabledeviceapi.h)

IPortableDevice 接口提供对便携式设备的访问。

若要创建并打开此接口，请先使用 CLSID_PortableDeviceFTM 或 CLSID_PortableDevice 调用 CoCreateInstance 以检索 IPortableDevice 接口，然后调用 Open 以打开与设备的连接。

继承

IPortableDevice 接口继承自 IUnknown 接口。 IPortableDevice 还具有以下类型的成员：

方法

IPortableDevice 接口包含以下方法。

IPortableDevice：：Advise Advise 方法注册接收设备事件的应用程序定义的回调。
IPortableDevice：：Cancel Cancel 方法取消此接口上的挂起操作。
IPortableDevice：：Capabilities Capabilities 方法检索用于查询可移植设备功能的接口。
IPortableDevice：：Close Close 方法关闭与设备的连接。
IPortableDevice：：Content Content 方法检索可用于访问设备上的对象的接口。
IPortableDevice：：GetPnPDeviceID GetPnPDeviceID 方法检索应用程序用于打开设备的即插即用 (PnP) 设备标识符。
IPortableDevice：：Open Open 方法打开应用程序与设备之间的连接。
IPortableDevice：：SendCommand SendCommand 方法将命令发送到设备，并同步检索结果。
IPortableDevice：：Unadvise Unadvise 方法取消注册客户端以接收回调通知。 如果之前调用了 Advise，则必须调用此方法。

注解

客户端接口设计用于任何 WPD 对象;无需为应用程序引用的每个对象创建新实例。 应用程序打开 IPortableDevice 接口的实例后，应打开并缓存所需的任何其他 WPD 客户端接口。

对于 Windows 7， IPortableDevice 支持 CoCreateInstance 的两个 CLSD。 CLSID_PortableDevice 返回不聚合自由线程封送处理程序的 IPortableDevice 指针; CLSID_PortableDeviceFTM 是一个新的 CLSID，它返回聚合自由线程封送处理程序的 IPortableDevice 指针。 否则，这两个指针都支持相同的功能。

位于单线程单元中的应用程序应使用 CLSID_PortableDeviceFTM ，因为这样可以消除接口指针封送的开销。 旧 版应用程序仍支持CLSID_PortableDevice。

要求

目标平台	Windows
标头	portabledeviceapi.h

请参阅

客户端接口