IMFMediaSession：：Start 方法 (mfidl.h)

啟動媒體會話。

語法

HRESULT Start(
  [in] const GUID        *pguidTimeFormat,
  [in] const PROPVARIANT *pvarStartPosition
);

[in] pguidTimeFormat

GUID 的指標，指定 pvarStartPosition 參數的時間格式。此參數可以是 Null。 NULL 值相當於傳入GUID_NULL。

定義下列時間格式 GUID：

值	意義
GUID_NULL	簡報時間。 pvarStartPosition 參數必須具有下列其中一個 PROPVARIANT 類型。 VT_I8： pvarStartPosition 參數包含相對於簡報開頭的 100 奈秒單位開始位置。 VT_EMPTY：播放會從目前的位置開始。所有媒體來源都支援這個時間格式。
MF_TIME_FORMAT_SEGMENT_OFFSET	區段位移。 Sequencer 來源支援這個時間格式。開始時間是區段內的位移。呼叫 MFCreateSequencerSegmentOffset 函式來建立 pvarStartPosition 參數的 PROPVARIANT 值。
MF_TIME_FORMAT_ENTRY_RELATIVE	注意需要 Windows 7 或更新版本。跳到播放清單專案。 pvarStartPosition 參數會指定播放清單專案的索引，相對於目前的專案。例如，值 2 會略過兩個專案。若要向後略過，請傳遞負值。 PROPVARIANT類型VT_I4。如果媒體來源支援這個時間格式， IMFMediaSource：：GetCharacteristics 方法會傳回下列其中一個或兩個旗標： MFMEDIASOURCE_CAN_SKIPFORWARD MFMEDIASOURCE_CAN_SKIPBACKWARD

值

意義

簡報時間。 pvarStartPosition 參數必須具有下列其中一個 PROPVARIANT 類型。

所有媒體來源都支援這個時間格式。

區段位移。 Sequencer 來源支援這個時間格式。開始時間是區段內的位移。

呼叫 MFCreateSequencerSegmentOffset 函式來建立 pvarStartPosition 參數的 PROPVARIANT 值。

注意需要 Windows 7 或更新版本。

跳到播放清單專案。 pvarStartPosition 參數會指定播放清單專案的索引，相對於目前的專案。例如，值 2 會略過兩個專案。若要向後略過，請傳遞負值。 PROPVARIANT類型VT_I4。

如果媒體來源支援這個時間格式， IMFMediaSource：：GetCharacteristics 方法會傳回下列其中一個或兩個旗標：

[in] pvarStartPosition

PROPVARIANT 的指標，指定播放的起始位置。此參數的意義和數據類型是由 pguidTimeFormat 參數表示。

方法會傳回 HRESULT。可能的值包括 (但不限於) 下表中的這些值。

呼叫此方法時，媒體會話會啟動簡報時鐘，並開始處理媒體範例。

這個方法是非同步方法。當方法完成時，媒體會話會傳送 MESessionStarted 事件。