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 デバイスマネージャーメソッドによって呼び出されます。その目的は、 Progress が推定ティックごとに 1 回呼び出されることです。ただし、実行される操作では推定ティックごとに 1 回の呼び出しが保証されない場合があるため、 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;
}