应用程序的接口
本部分介绍使用 Windows Media 设备管理器 SDK 与设备通信的应用程序使用或实现的接口。 此处使用的术语“应用程序”是指台式计算机上存在且需要与连接的便携式设备进行高级通信的任何可执行文件、插件或 COM 对象。 这可以包括媒体播放器应用程序、Windows 媒体播放器插件 (（如果需要直接访问便携式设备) ）或播放计数计量 COM 对象。
其中一些接口由应用程序实现，而其他接口由应用程序调用。 每个接口的文档指示它是 (实现还是调用，如果已实现，则它是可选的还是必需的) 。
应用程序使用以下接口或类。
| 接口或类 | 说明 |
|---|---|
| CSecureChannelClient 类 | 一个帮助程序类，使应用程序能够自行进行身份验证、加密和解密数据以及创建 MAC。 |
| IWMDeviceManager | 应用程序的顶级 Windows Media 设备管理器 接口。 |
| IWMDeviceManager2 | 通过提供高级枚举方法和其他方法扩展 IWMDeviceManager 。 |
| IWMDeviceManager3 | 通过提供设置设备枚举首选项的方法扩展 IWMDeviceManager2 接口。 |
| IWMDMDevice | 提供检查和浏览单个便携式设备的方法。 |
| IWMDMDevice2 | 通过获取设备支持的视频格式、按名称查找存储以及使用属性页，扩展 IWMDMDevice 。 |
| IWMDMDevice3 | 通过提供查询设备属性的方法、发送设备 I/O 控件代码以及提供用于搜索存储和检索设备格式功能的升级方法，扩展 IWMDMDevice2 。 |
| IWMDMDeviceControl | 提供用于控制设备的方法。 |
| IWMDMDeviceSession | 通过将多个操作捆绑到一个会话中来提高设备操作的效率 |
| IWMDMEnumDevice | 枚举连接到计算机的便携式设备。 |
| IWMDMEnumStorage | 枚举设备上的存储。 |
| IWMDMMetaData | 设置和检索存储) (的元数据属性，例如艺术家、专辑、流派等。 |
| IWMDMObjectInfo | 获取和设置控制 IWMDMDeviceControl 接口如何处理设备上的可播放文件的信息 |
| IWMDMRevoked | 检索 URL，如果传输失败并出现吊销错误，则可以从中下载更新的组件。 |
| IWMDMStorage | 提供检查和浏览设备上的存储 (文件、文件夹、播放列表) 的方法。 |
| IWMDMStorage2 | 扩展 IWMDMStorage ，方法是可以按名称获取子存储，并获取和设置扩展属性。 |
| IWMDMStorage3 | 通过公开元数据扩展 IWMDMStorage2 。 |
| IWMDMStorage4 | 通过提供检索存储的可用元数据子集以及设置和检索对其他存储的引用列表的方法，扩展 IWMDMStorage3 。 |
| IWMDMStorageControl | 用于在设备内或设备和计算机之间插入、删除或移动文件。 |
| IWMDMStorageControl2 | 扩展 IWMDMStorageControl ，方法是在将内容插入存储时设置目标文件的名称。 |
| IWMDMStorageControl3 | 通过允许传入 IWMDMMetaData 接口指针，扩展 IWMDMStorageControl2。 |
| IWMDMStorageGlobals | 提供检索有关存储介质 (（如设备上的闪存 ROM 卡) ）的全局信息的方法。 |
| IWMDRMDeviceApp | 使应用程序能够执行设备的 DRM 组件的计量、许可证同步和更新。 |
| IWMDRMDeviceApp2 | 通过提供新版本的 QueryDeviceStatus 方法扩展 IWMDRMDeviceApp。 |
回调接口
以下可选接口由应用程序实现，用于跟踪异步请求（例如读取或写入请求）的进度。
| 接口 | 说明 |
|---|---|
| IWMDMNotification | 允许应用程序和服务提供商在设备或内存存储 (（如 RAM 卡) ）与计算机连接或断开连接时接收通知。 |
| IWMDMOperation2 | 通过提供获取和设置扩展属性的方法扩展 IWMDMOperation 。 |
| IWMDMOperation3 | 通过提供一种用于传输未加密数据的新方法来扩展 IWMDMOperation ，以提高效率。 |
| IWMDMOperation | 允许应用程序控制在文件传输期间如何从计算机读取数据或将数据写入计算机。 |
| IWMDMProgress2 | 通过提供状态指示器扩展 IWMDMProgress：：End 方法。 |
| IWMDMProgress3 | 通过提供其他输入参数来指定事件 ID 和特定于上下文的信息，扩展 IWMDMProgress2 。 |
| IWMDMProgress | 允许应用程序跟踪操作进度，例如设置媒体格式或文件传输。 |
下图显示了如何从根 IWMDeviceManager 接口获取大多数重要应用程序接口。 应用程序通过共同创建 MediaDevMgr 对象、请求 IComponentAuthenticate 接口、对组件进行身份验证，然后请求 IWMDeviceManager 来获取此根接口 (对 应用程序) 进行身份验证 中所述的步骤。 获取此根接口后，将调用 IWMDeviceManager：：EnumDevices 来创建实现 IWMDMEnumDevice 的对象。 其他接口是通过按所示顺序调用接口上的方法获取的。 派生接口（如 IWMDMDevice2 ）是通过在基接口上调用 QueryInterface 获取的。
在下图中，派生接口用斜杠标记，因此“IWMDMStorage/2/3”表示 IWMDMStorage、 IWMDMStorage2 和 IWMDMStorage3。
相关主题