IMFClockStateSink::OnClockStart メソッド (mfidl.h)

プレゼンテーション クロックの開始時に呼び出されます。

構文

HRESULT OnClockStart(
  [in] MFTIME   hnsSystemTime,
  [in] LONGLONG llClockStartOffset
);

パラメーター

[in] hnsSystemTime

クロックが開始されたシステム時刻 (100 ナノ秒単位)。

[in] llClockStartOffset

クロックの新しい開始時刻 (100 ナノ秒単位)。 このパラメーターは、クロック が現在の位置から開始または再起動されたことを示すPRESENTATION_CURRENT_POSITIONに等しい場合もあります。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

このメソッドは、プレゼンテーション クロックの IMFPresentationClock::Start メソッドが呼び出されたときに呼び出されます。ただし、クロックが一時停止され、値が PRESENTATION_CURRENT_POSITION で Start が呼び出された場合、IMFClockStateSink::OnClockRestart は OnClockStart の代わりに呼び出されます。

クロックは、タイム ソースの OnClockStart メソッドを呼び出して、プレゼンテーションのタイム ソースに通知します。 この呼び出しは 、Start メソッド内で同期的に行われます。 タイム ソースから OnClockStart からエラーが返された場合、プレゼンテーション クロックの Start メソッドはエラーを返し、状態の変更は行われません。

プレゼンテーションの時刻ソースではないオブジェクトの場合、 OnClockStart メソッドは、状態の変更が完了した後に非同期的に呼び出されます。 その場合、このメソッドからの戻り値は無視されます。

llClockStartOffset に指定された値は、クロックが開始されるプレゼンテーション時間であるため、プレゼンテーションの開始に対する相対値です。 メディア シンクは、 llClockStartOffSet より前のプレゼンテーション時間のデータをレンダリングしないでください。 サンプルがオフセットをまたぐ場合 (つまり、オフセットがサンプルの開始時刻と終了時刻の間にある場合)、シンクは 、llClockStartOffset の後のデータのみがレンダリングされるようにサンプルをトリミングするか、単にサンプルを削除する必要があります。

要件

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

関連項目

IMFClockStateSink

MFTIME

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