IWMDMProgress3

省略可能で、アプリケーションが実装する IWMDMProgress3 インターフェイスは、監視対象のイベントを指定するための追加の入力パラメーターと、コンテキスト固有の情報を渡す手段を提供することで IWMDMProgress2 を拡張します。このコールバックインターフェイスを実装するアプリケーションは、新しいメソッドに加えて、下位互換性のために IWMDMProgress および IWMDMProgress2 に対応するメソッドも実装する必要があります。

Begin3 メソッドは、操作が開始されようとしていることを示すために Windows Media Device Manager から呼び出されます。

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

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

例

次の C++ コードは、Begin3 の実装例を示します。

HRESULT Begin3(GUID  EventId, DWORD  dwEstimatedTicks, OPAQUECOMMAND*  pContext)
{
    WCHAR strGuid[64];
    StringFromGUID2(reinterpret_cast<GUID&>(EventId),(LPOLESTR)strGuid, 64);
    // TODO: Display the message "IWMDMProgress3::Begin3 called." 
    // followed by the strGuid value.
    return S_OK;
}

Progress3 メソッドは、進行中の処理の状況を示すために Windows Media Device Manager から呼び出されます。

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

操作を実装するメソッドを所有するインターフェイスは、そのメソッドで定義された操作の実行中に Progress3 メソッドを呼び出します。Progress3 は推定ティック 1 回につき 1 回呼び出されることを想定していますが、実行中の操作が推定ティックごとに 1 回の呼び出しを保証するとは限らないため、呼び出しのたびに dwTranspiredTicks パラメーターを確認する必要があります。

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

例

次の C++ コードは、Progress3 の実装例を示します。

HRESULT Progress3(GUID  EventId, DWORD  dwTranspiredTicks, OPAQUECOMMAND*  pContext)
{
    WCHAR strGuid[64];
    ZeroMemory(strGuid, 64);
    StringFromGUID2(reinterpret_cast<GUID&>(EventId),(LPOLESTR)strGuid, 64);
    // TODO: Display the message: "Progress3 called. GUID value: " 
    // followed by the strGUID value.
    // TODO: Display the message: "Progress3 dwTranspiredTicks: " 
    // followed by the dwTranspiredTicks value.

    return S_OK;
}

End3 メソッドは、操作が完了したことを示すために Windows Media Device Manager から呼び出されます。

このメソッドが呼び出される時点で現在の操作は完了またはキャンセルされているため、Windows Media Device Manager は End3 メソッドが返す戻り値を無視します。

操作を実装するメソッドを所有するインターフェイスは、そのメソッドで定義された操作が完了したときに End3 を呼び出します。

例

次の C++ コードは、End3 の実装例を示します。

HRESULT End3(GUID  EventId, HRESULT  hrCompletionCode, OPAQUECOMMAND*  pContext)
{
    // TODO: Display the message "IWMDMProgress3::End3 called."
    return S_OK;
}