IMFPresentationClock::P ause メソッド (mfidl.h)

  • [アーティクル]

プレゼンテーションクロックを一時停止します。 クロックが一時停止されている間、クロック時間は進まず、クロックの IMFPresentationClock::GetTime はクロックが一時停止された時刻を返します。

構文

HRESULT Pause();

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード 説明
S_OK
 メソッドが成功しました。
MF_E_CLOCK_NO_TIME_SOURCE
 このクロックにタイム ソースが設定されていません。
MF_E_CLOCK_STATE_ALREADY_SET
 クロックは既に一時停止されています。
MF_E_INVALIDREQUEST
 クロックが停止しています。 クロックが停止している場合、この要求は無効です。

解説

このメソッドは、クロックが実行されている場合に有効です。 クロックが一時停止または停止している場合は無効です。

プレゼンテーション クロックは、時計のタイム ソースで IMFClockStateSink::OnClockPause を呼び出すことによって、状態の変更を開始します。 この呼び出しは同期的に行われます。 失敗した場合、状態の変更は行われません。 呼び出しが成功すると、状態が変更され、クロックは OnClockPause メソッドを呼び出すことによって、他の状態変更サブスクライバーに通知します。 これらの呼び出しは非同期的に行われます。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー mfidl.h
Library Mfuuid.lib

関連項目

IMFPresentationClock

プレゼンテーションクロック