IWMDMProgress：：Begin 方法 (mswmdm.h)

發行項
03/05/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;
}