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

發行項
03/13/2024

Progress 方法表示作業仍在進行中。

語法

HRESULT Progress(
  [in] DWORD dwTranspiredTicks
);

參數

[in] dwTranspiredTicks

DWORD ，指定到目前為止已轉譯的刻度數目。

傳回值

應用程式應該會傳回下列其中一個 HRESULT 值。

傳回碼	描述
S_OK	作業應該會繼續。
WMDM_E_USER_CANCELLED	Windows Media 裝置管理員應該取消目前的作業，而不等待它完成。如果應用程式使用區塊模式，則 Windows Media 裝置管理員會將此錯誤傳回給應用程式。

備註

所有其他 Windows Media 裝置管理員方法都會呼叫此方法。其目的是每個估計刻度都會呼叫 Progress 一次。不過，必須在每個呼叫上檢查 dwTran commitedTicks 參數，因為執行中的作業不保證每個估計刻度的呼叫一次。

應用程式會將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;
}