培训
WPD 应用程序编程接口
WPD 应用程序编程接口技术概述。
若要开发 WPD 应用程序编程接口,需要以下标头:
有关此技术的编程指南,请参阅:
建议 Advise 方法注册接收设备事件的应用程序定义的回调。 |
建议 注册接收服务事件的应用程序定义的回调对象。 |
取消 Cancel 方法取消挂起的操作。 (IEnumPortableDeviceObjectIDs.Cancel) |
取消 Cancel 方法取消此接口上的挂起操作。 |
取消 Cancel 方法取消此接口上的挂起请求。 |
取消 Cancel 方法取消此接口上调用的挂起操作。 |
取消 Cancel 方法取消此接口上正在进行的调用。 |
取消 Cancel 方法取消挂起的调用。 |
取消 Cancel 方法取消挂起的属性请求。 |
取消 Cancel 方法取消挂起的操作。 (IPortableDeviceResources.Cancel) |
取消 取消此接口上的挂起操作。 |
取消 取消挂起的操作。 |
取消 取消挂起的方法调用。 |
取消 取消连接或断开 MTP/蓝牙设备的挂起请求。 |
功能 Capabilities 方法检索用于查询可移植设备功能的接口。 |
功能 检索服务功能。 |
克隆 Clone 方法复制当前 IEnumPortableDeviceObjectIDs 接口。 |
关闭 Close 方法关闭与设备的连接。 |
关闭 释放与服务的连接。 |
“连接” 向 MTP/蓝牙设备发送异步连接请求。 |
内容 Content 方法检索可用于访问设备上的对象的接口。 |
内容 检索对服务内容的访问权限。 |
复制 Copy 方法将对象从设备上的一个位置复制到另一个位置。 |
CreateObjectWithPropertiesAndData CreateObjectWithPropertiesAndData 方法创建具有设备上的属性和数据的对象。 |
CreateObjectWithPropertiesOnly CreateObjectWithPropertiesOnly 方法创建设备上仅具有属性的对象。 |
CreateResource CreateResource 方法创建资源。 |
删除 Delete 方法从设备中删除一个或多个对象。 |
删除 Delete 方法从设备上的指定对象中删除指定属性。 |
删除 Delete 方法从 pszObjectID 参数标识的对象中删除一个或多个资源。 |
断开连接 向 MTP/蓝牙设备发送异步断开连接请求。 |
EnumObjects EnumObjects 方法检索用于枚举对象的直接子对象的接口。 它有一个可选的筛选器,可以枚举具有特定属性的对象。 |
GetCommandOptions GetCommandOptions 方法检索设备上指定命令的所有支持选项。 |
GetCommandOptions 检索 WPD 命令的选项。 |
GetDeviceDescription 检索设备的说明。 |
GetDeviceForService 检索与指定服务关联的设备。 |
GetDeviceFriendlyName 检索设备的用户友好名称。 |
GetDeviceManufacturer 检索设备制造商的名称。 |
GetDeviceProperty 检索计算机上设备存储的属性值。 (这些属性不是由 Windows Portable Devices.) 定义的标准属性。 |
GetDevices 检索连接到计算机的便携式设备的列表。 |
GetDeviceServices 检索与指定设备关联的服务的列表。 |
GetEventAttributes 检索事件的属性。 |
GetEventOptions GetEventOptions 方法检索设备上指定事件的所有支持选项。 |
GetEventParameterAttributes 检索事件参数的属性。 |
GetFixedPropertyAttributes GetFixedPropertyAttributes 方法检索指定属性和格式的标准属性属性。 |
GetFormatAttributes 检索格式的属性。 |
GetFormatPropertyAttributes 检索格式属性的属性。 |
GetFormatRenderingProfiles 检索格式的呈现配置文件。 |
GetFunctionalCategories GetFunctionalCategories 方法检索设备支持的所有功能类别。 |
GetFunctionalObjects GetFunctionalObjects 方法检索与设备上的指定类别匹配的所有功能对象。 |
GetInheritedServices 检索具有指定继承类型的服务。 |
GetMethodAttributes 检索用于描述给定方法的属性。 |
GetMethodParameterAttributes 检索用于描述给定方法参数的属性。 |
GetObjectID GetObjectID 方法检索写入设备的资源的对象 ID。 此方法仅在对数据流调用 IStream::Commit 后有效。 |
GetObjectIDsFromPersistentUniqueIDs GetObjectIDsFromPersistentUniqueIDs 方法检索一个或多个对象的当前对象 ID,因为其持久性唯一 ID (PUID) 。 |
GetPnPDeviceID GetPnPDeviceID 方法检索应用程序用于打开设备的即插即用 (PnP) 设备标识符。 |
GetPnPID 检索连接器的即插即用 (PnP) 设备标识符。 |
GetPnPServiceID 检索服务的即插即用 (PnP) 标识符。 |
GetPrivateDevices GetPrivateDevices 方法检索连接到计算机的专用可移植设备的列表。 只能通过专为这些特定设备设计的应用程序访问这些专用设备。 |
GetProperty 检索给定 MTP/蓝牙总线枚举器设备的 属性。 |
GetPropertyAttributes GetPropertyAttributes 方法检索设备上指定对象属性的属性。 |
GetResourceAttributes GetResourceAttributes 方法从 对象中的指定资源检索所有属性。 |
GetServiceObjectID 检索服务的对象标识符。 例如,此对象标识符可用于访问服务的属性。 |
GetStream GetStream 方法获取 IStream 接口,用于读取或写入设备上的 对象中的内容数据。 检索到的接口使你能够读取或写入对象数据。 |
GetSupportedCommands GetSupportedCommands 方法检索此设备支持的所有命令的列表。 |
GetSupportedCommands 检索服务支持的命令。 |
GetSupportedContentTypes GetSupportedContentTypes 方法检索设备上指定功能对象类型的所有受支持的内容类型。 |
GetSupportedEvents GetSupportedEvents 方法检索此设备支持的事件。 |
GetSupportedEvents 检索服务支持的事件。 |
GetSupportedFormatProperties GetSupportedFormatProperties 方法检索设备上指定格式的对象支持的属性。 |
GetSupportedFormatProperties 检索指定格式的服务支持的属性。 |
GetSupportedFormats GetSupportedFormats 方法检索设备上指定对象类型的支持格式。 例如,指定音频对象可能会返回WPD_OBJECT_FORMAT_WMA、WPD_OBJECT_FORMAT_WAV和WPD_OBJECT_FORMAT_MP3。 |
GetSupportedFormats 检索服务支持的格式。 |
GetSupportedMethods 检索服务支持的方法。 |
GetSupportedMethodsByFormat 检索指定格式的服务支持的方法。 |
GetSupportedProperties GetSupportedProperties 方法检索指定对象支持的属性列表。 请注意,并非所有这些属性实际上都有值。 |
GetSupportedResources GetSupportedResources 方法检索特定对象支持的资源列表。 |
GetValues GetValues 方法从设备上的指定对象中检索指定属性的列表。 |
Invoke 同步调用 方法。 |
InvokeAsync 异步调用 方法。 |
方法 检索用于在服务上调用自定义功能的 IPortableDeviceServiceMethods 接口。 |
移动 Move 方法将一个或多个对象从设备上的一个位置移到另一个位置。 |
下一页 Next 方法检索枚举序列中接下来的一个或多个对象 ID。 |
OnComplete 指示回调方法已完成执行。 |
OnEnd 当 IPortableDevicePropertiesBulk::Start 启动的批量操作完成时,SDK 将调用 OnEnd 方法。 |
OnEvent SDK 调用 OnEvent 方法以通知应用程序有关异步事件的信息。 |
OnProgress 当 IPortableDevicePropertiesBulk::Start 启动的批量操作已将数据发送到设备并接收回一些信息时,SDK 将调用 OnProgress 方法。 |
OnStart 当 IPortableDevicePropertiesBulk::Start 启动的批量操作即将开始时,SDK 将调用 OnStart 方法。 |
打开 Open 方法打开应用程序与设备之间的连接。 |
打开 打开与服务的连接。 |
属性 Properties 方法检索获取或设置设备上对象的属性所需的接口。 |
QueueGetValuesByObjectFormat QueueGetValuesByObjectFormat 接口对设备上特定格式的对象属性的请求进行排队。 |
QueueGetValuesByObjectList QueueGetValuesByObjectList 方法对来自设备上的一个或多个指定对象的一个或多个指定属性的请求进行排队。 |
QueueSetValuesByObjectList QueueSetValuesByObjectList 方法将请求排队,以在设备上的一个或多个指定对象上设置一个或多个指定值。 |
RefreshDeviceList RefreshDeviceList 方法刷新连接到计算机的设备列表。 |
重置 Reset 方法将枚举序列重置为开头。 (IEnumPortableDeviceObjectIDs.Reset) |
SeekInUnits SeekInUnits 方法基于备用单位对流执行查找。 |
SendCommand SendCommand 方法将命令发送到设备,并同步检索结果。 |
SendCommand 将标准 WPD 命令及其参数发送到服务。 |
SetProperty 设置 MTP/蓝牙总线枚举器设备上的给定属性。 |
SetValues SetValues 方法添加或修改设备上的指定对象上的一个或多个属性。 |
Skip Skip 方法跳过枚举序列中指定数量的对象。 |
启动 Start 方法启动排队的操作。 |
转移 Transfer 方法检索一个接口,该接口用于读取或写入现有对象资源的内容数据。 |
取消添加 Unadvise 方法取消注册客户端以接收回调通知。 如果之前调用了 Advise,则必须调用此方法。 |
取消添加 取消注册服务事件回调对象。 |
UpdateObjectWithPropertiesAndData 使用在设备上找到的属性和数据汇报对象。 |
IEnumPortableDeviceObjectIDs IEnumPortableDeviceObjectIDs 接口枚举可移植设备上的对象。 最初通过在设备上调用 IPortableDeviceContent::EnumObjects 来获取此接口。 |
IPortableDevice IPortableDevice 接口提供对便携式设备的访问。 |
IPortableDeviceCapabilities IPortableDeviceCapabilities 接口了各种设备功能,包括支持的格式、命令和功能对象。 可以通过调用 IPortableDevice::Capabilities 从设备检索此接口。 |
IPortableDeviceConnector 定义用于配对 MTP/蓝牙设备的连接管理和属性检索的方法。 |
IPortableDeviceContent IPortableDeviceContent 接口提供在设备上创建、枚举、检查和删除内容的方法。 若要获取此接口,请调用 IPortableDevice::Content。 |
IPortableDeviceContent2 定义其他方法,这些方法提供对设备上找到的内容的访问。 |
IPortableDeviceDataStream IPortableDeviceDataStream 接口在用于数据传输的 IStream 上公开其他方法。 |
IPortableDeviceEventCallback 如果应用程序已注册通过调用 IPortableDevice::Advise 接收异步回调,则应用程序实现的 IPortableDeviceEventCallback 接口用于接收异步回调。 |
IPortableDeviceManager 枚举连接到计算机的设备,并提供一种简单的方法来请求安装信息,包括制造商、友好名称和说明。 |
IPortableDeviceProperties IPortableDeviceProperties 接口从设备上的对象或设备本身检索、添加或删除属性。 |
IPortableDevicePropertiesBulk IPortableDevicePropertiesBulk 接口异步查询或设置设备上的多个对象上的多个属性。 |
IPortableDevicePropertiesBulkCallback IPortableDevicePropertiesBulkCallback 接口由应用程序实现,以跟踪使用 IPortableDevicePropertiesBulk 接口启动的异步操作的进度。应用程序调用 IPortableDevicePropertiesBulk::Start 后,Windows 可移植设备先调用 IPortableDevicePropertiesBulkCallback::OnStart,然后反复调用 IPortableDevicePropertiesBulkCallback::OnProgress,直到操作完成或应用程序调用 IPortableDevicePropertiesBulk::Cancel 或返回 OnProgress 的错误值。 最后,无论操作是否成功完成,Windows 可移植设备都会调用 IPortableDevicePropertiesBulkCallback::OnEnd。 |
IPortableDeviceResources IPortableDeviceResources 接口提供对对象原始数据的访问权限。 使用此接口读取或写入对象中的资源。 若要获取此接口,请调用 IPortableDeviceContent::Transfer。 |
IPortableDeviceService 提供对服务的访问权限。 |
IPortableDeviceServiceCapabilities 检索描述服务功能的信息。 |
IPortableDeviceServiceManager 检索与服务关联的设备,以及设备上找到的服务列表。 |
IPortableDeviceServiceMethodCallback 包含应用程序用于跟踪回调方法完成情况的方法。 异步调用服务方法的应用程序可以实现此接口,并将其作为参数提供给 IPortableDeviceServiceMethods::InvokeAsync。 |
IPortableDeviceServiceMethods 调用或取消对服务的方法的调用。 |
IPortableDeviceUnitsStream IPortableDeviceUnitsStream 接口提供了一种使用其他单位(如帧或毫秒)对流进行操作或查找的方法。 |