IWMDMProgress：:P rogress 方法 (mswmdm.h)

项目
03/05/2024

Progress 方法指示操作仍在进行中。

语法

HRESULT Progress(
  [in] DWORD dwTranspiredTicks
);

参数

[in] dwTranspiredTicks

DWORD ，指定到目前为止已发生的时钟周期数。

返回值

应用程序应返回以下 HRESULT 值之一。

返回代码	说明
S_OK	操作应继续。
WMDM_E_USER_CANCELLED	Windows Media 设备管理器应取消当前操作，而无需等待操作完成。如果应用程序使用块模式，则 Windows Media 设备管理器会将此错误返回给应用程序。

注解

此方法由所有其他 Windows Media 设备管理器方法调用。目的是按估计的计时周期调用进度一次。但是，必须在每次调用中检查 dwTranspiredTicks 参数，因为所执行的操作可能无法保证每次估计的时钟周期调用一次。

应用程序将S_OK返回到调用方法，以指示操作应继续。应用程序返回WMDM_E_USER_CANCELLED指示应取消该操作。如果应用程序使用块模式并返回WMDM_E_USER_CANCELLED，则 Windows Media 设备管理器将向应用程序返回相同的错误。

示例

以下 C++ 代码是 Progress 方法的简单实现。


HRESULT Progress(DWORD  dwTranspiredTicks)
{
    // TODO: Display the message: "IWMDMProgress::Progress called" 
    // followed by the dwTranspiredTicks value.
    return S_OK;
}