IPortableDevice 接口 (portabledeviceapi.h)

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

若要创建并打开此接口,请先使用 CLSID_PortableDeviceFTMCLSID_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

请参阅

客户端接口