IWMDMProgress::Begin メソッド (mswmdm.h)

[アーティクル]
02/29/2024

Begin メソッドは、操作が開始されていることを示します。可能な場合は、操作の期間の見積もりが提供されます。

構文

HRESULT Begin(
  [in] DWORD dwEstimatedTicks
);

パラメーター

[in] dwEstimatedTicks

操作の完了に必要なティックの推定数を指定する DWORD。

戻り値

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

リターンコード	説明
S_OK	操作は続行する必要があります。
WMDM_E_USER_CANCELLED	Windows Media デバイスマネージャーでは、完了するまで待たずに現在の操作を取り消す必要があります。アプリケーションがブロックモードを使用している場合、Windows Media デバイスマネージャーはこのエラーをアプリケーションに返します。

注釈

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