IMFPresentationClock::Start メソッド (mfidl.h)
プレゼンテーションクロックを開始します。
構文
HRESULT Start(
[in] LONGLONG llClockStartOffset
);
パラメーター
[in] llClockStartOffset
最初の開始時刻 (100 ナノ秒単位)。 Start メソッドが呼び出されると、クロックの IMFPresentationClock::GetTime メソッドはこの値を返し、そこからクロック時間がインクリメントされます。 値がPRESENTATION_CURRENT_POSITION場合、クロックは現在の位置から開始されます。 クロックが一時停止していて、同じ位置から再開する場合は、この値を使用します。
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
このクロックにタイム ソースが設定されませんでした。 |
注釈
このメソッドは、すべての状態 (停止、一時停止、または実行中) で有効です。
クロックが一時停止され、同じ位置から再起動された場合 (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 |