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 |