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

こちらもご覧ください

IMFMediaEngineEx