IWMDMProgress

アプリケーション側で実装する省略可能なインターフェースである IWMDMProgress を使用すると、メディアのフォーマットやファイル転送などの操作の進行状況をアプリケーションで追跡できます。

Begin メソッドは、操作が開始されることを示します。可能な場合は、その操作にかかる時間の推定値が渡されます。

アプリケーションは、次のいずれかの HRESULT 値を返す必要があります。

このメソッドは、操作が開始されることを示すためにさまざまなメソッドから呼び出されます。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;
}

Progress メソッドは、操作がまだ進行中であることを示します。

アプリケーションは、次のいずれかの HRESULT 値を返す必要があります。

このメソッドは、他のすべての Windows Media Device Manager のメソッドから呼び出されます。Progress は推定ティックごとに 1 回呼び出されることを想定していますが、実行中の操作が推定ティックごとに 1 回の呼び出しを保証するとは限らないため、呼び出しのたびに dwTranspiredTicks パラメーターを確認する必要があります。

操作を続行することを示すには、アプリケーションは呼び出し元のメソッドに S_OK を返します。操作をキャンセルすることを示すには、WMDM_E_USER_CANCELLED を返します。アプリケーションがブロックモードを使用していて WMDM_E_USER_CANCELLED を返した場合、Windows Media Device Manager は同じエラーをアプリケーションに返します。

例

次の C++ コードは、Progress メソッドの簡単な実装例です。

HRESULT Progress(DWORD  dwTranspiredTicks)
{
    // TODO: Display the message: "IWMDMProgress::Progress called" 
    // followed by the dwTranspiredTicks value.
    return S_OK;
}

End メソッドは、操作が完了したことを示します。

このメソッドの戻り値は、Windows Media Device Manager によって無視されます。

このメソッドは、操作が終了することを示すためにさまざまなインターフェースから呼び出されます。このメソッドが呼び出される時点で操作は既に完了または終了しているため、Windows Media Device Manager は End メソッドが返す戻り値をすべて無視します。

例

次の C++ コードは、End メソッドの実装例です

HRESULT End()
{
    // TODO: Display the message: "IWMDMProgress::End called."
    return S_OK; // Unnecessary, since this is ignored.
}