IMFMediaSinkPreroll::NotifyPreroll メソッド (mfidl.h)

プレゼンテーション クロックが開始されようとしていることをメディア シンクに通知します。

構文

HRESULT NotifyPreroll(
  [in] MFTIME hnsUpcomingStartTime
);

パラメーター

[in] hnsUpcomingStartTime

プレゼンテーション クロックの今後の開始時刻 (100 ナノ秒単位)。 この時刻は、プレゼンテーション クロックの開始時に IMFPresentationClock::Start メソッドに指定されるのと同じ値です。

戻り値

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

解説

このメソッドが呼び出されると、 が十分なプリロール データを持つまで、メディア シンクは任意の数の MEStreamSinkRequestSample イベントを送信してサンプルを要求します。 十分なプリロール データがある場合、メディア シンクは MEStreamSinkPrerolled イベントを 送信します。 このイベントは、クライアントがプレゼンテーション クロックを開始できることを通知します。

プリロール中に、メディア シンクは、受け取ったサンプルを準備して、レンダリングする準備を整えることができます。 クロックが開始されるまで、実際にはサンプルはレンダリングされません。

要件

関連項目

IMFMediaSinkPreroll

MFTIME

メディア シンク