IWMDMProgress::P rogress メソッド (mswmdm.h)

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

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	mswmdm.h
Library	Mssachlp.lib

こちらもご覧ください

通知の有効化

IWMDMProgress インターフェイス

IWMDMProgress3::P rogress3