IMFPresentationClock::Start メソッド (mfidl.h)

  • [アーティクル]

プレゼンテーションクロックを開始します。

構文

HRESULT Start(
  [in] LONGLONG llClockStartOffset
);

パラメーター

[in] llClockStartOffset

最初の開始時刻 (100 ナノ秒単位)。 Start メソッドが呼び出されると、クロックの IMFPresentationClock::GetTime メソッドはこの値を返し、そこからクロック時間がインクリメントされます。 値がPRESENTATION_CURRENT_POSITION場合、クロックは現在の位置から開始されます。 クロックが一時停止していて、同じ位置から再開する場合は、この値を使用します。

戻り値

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

リターン コード 説明
S_OK
 メソッドが成功しました。
MF_E_CLOCK_NO_TIME_SOURCE
 このクロックにタイム ソースが設定されませんでした。

注釈

このメソッドは、すべての状態 (停止、一時停止、または実行中) で有効です。

クロックが一時停止され、同じ位置から再起動された場合 (llClockStartOffset がPRESENTATION_CURRENT_POSITION)、プレゼンテーション クロックは IMFClockStateSink::OnClockRestart 通知を送信します。 それ以外の場合、クロックは IMFClockStateSink::OnClockStart 通知を 送信します。

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

クロックが既に実行されている場合は、 Start を再度呼び出すと、クロックを新しい StartOffset 位置にシークする効果があります。

要件

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

こちらもご覧ください

IMFPresentationClock

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