IMFMediaEngineEx::SetTimelineMarkerTimer メソッド (mfmediaengine.h)
メディア エンジンがマーカー イベントを送信するプレゼンテーション時刻を指定します。
構文
HRESULT SetTimelineMarkerTimer(
[in] double timeToFire
);
パラメーター
[in] timeToFire
マーカー イベントのプレゼンテーション時間 (秒単位)。
戻り値
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
再生が timeToFire で指定された時間に達すると、メディア エンジンは IMFMediaEngineNotify::EventNotify メソッドを介してMF_MEDIA_ENGINE_EVENT_TIMELINE_MARKER イベントを送信します。 このメソッドを呼び出すと、保留中の以前のマーカーが取り消されます。
アプリケーションがマーカー ポイントを超えてシークする場合、メディア エンジンはマーカーを取り消し、イベントを送信しません。
前方再生中に、 timeToFire を現在の再生位置より大きい値に設定します。 逆再生中に、 timeToFire を再生位置より小さい値に設定します。
マーカーを取り消すには、 IMFMediaEngineEx::CancelTimelineMarkerTimer を呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mfmediaengine.h |