IWMDMProgress3：：End3 方法 (mswmdm.h)

项目
02/29/2024

Windows Media 设备管理器调用 End3 方法以指示操作已完成。此方法通过为事件的标识 (ID) 和指向命令上下文的指针提供其他输入参数来扩展 IWMDMProgress2：：End2 。

语法

HRESULT End3(
  [in]      GUID          EventId,
  [in]      HRESULT       hrCompletionCode,
  [in, out] OPAQUECOMMAND *pContext
);

参数

[in] EventId

指定正在结束的事件的 GUID 。下表中显示了可能的值。

事件	说明
SCP_EVENTID_ACQSECURECLOCK	Windows Media 设备管理器正在从服务器获取安全时钟。
SCP_EVENTID_NEEDTOINDIV	设备正在个性化。当前未使用此功能。
SCP_EVENTID_DRMINFO	此事件 ID 用于使用每个文件的内容中找到的版本 DRM 标头通知应用程序。返回的 OPAQUECOMMAND 结构将 guidCommand 成员设置为 SCP_PARAMID_DRMVERSION。此外，数据指定以下标志之一： WMDM_SCP_DRMINFO_NOT_DRMPROTECTED WMDM_SCP_DRMINFO_V1HEADER WMDM_SCP_DRMINFO_V2HEADER
EVENT_WMDM_CONTENT_TRANSFER	正在向设备传输内容或从设备传输内容。

[in] hrCompletionCode

指定正在进行的操作的完成代码的 HRESULT。 hrCompletionCode 参数是结束的操作的返回代码。此参数可以是任何 HRESULT，包括标准 COM 错误代码、转换为 HRESULT 的 Win32 错误代码或 Windows Media 设备管理器错误代码。

[in, out] pContext

指向 OPAQUECOMMAND 结构的指针，该结构包含直接发送到设备的命令，而无需由 Windows Media 设备管理器处理。此参数是可选的，可以为 NULL。上下文结构是组件将任何相关数据与事件一起发送到应用程序的方式。发送此结构的组件应定义应用程序如何解释此数据结构。

返回值

Windows Media 设备管理器忽略 End3 方法返回的任何返回代码，因为当前操作在调用此方法之前已完成或取消。

注解

当方法定义的操作完成时，拥有实现操作的方法的接口将调用 End3 。

示例

以下 C++ 代码演示 了 End3 的示例实现。


HRESULT End3(GUID  EventId, HRESULT  hrCompletionCode, OPAQUECOMMAND*  pContext)
{
    // TODO: Display the message "IWMDMProgress3::End3 called."
    return S_OK;
}