iWMDMProgress：：Begin 方法 (mswmdm.h)

项目
02/29/2024

Begin 方法指示操作正在开始。尽可能提供操作持续时间的估计值。

语法

HRESULT Begin(
  [in] DWORD dwEstimatedTicks
);

参数

[in] dwEstimatedTicks

DWORD ，指定完成操作所需的估计计时周期数。

返回值

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

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

注解

此操作由各种方法调用，以指示操作正在开始。 dwEstimatedTicks 中传递的时钟周期数是完成操作所需的时钟周期数的估计值。在操作过程中，调用 Progress 方法以指示已发生的时钟周期数。应用程序可以使用估算配置显示进度的显示机制。

IWMDMProgress3：：Begin3 方法提供有关正在发生的操作的详细信息。

示例

以下 C++ 代码是 Begin 方法的实现。


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