通过

iWMDMProgress：：Begin 方法 (mswmdm.h)

  • 项目

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;
}

要求

要求 值
目标平台 Windows
标头 mswmdm.h
Library Mssachlp.lib

另请参阅

启用通知

IWMDMProgress 接口

IWMDMProgress3：：Begin3