共用方式為


IMFSourceReader::SetCurrentPosition 方法(mfreadwrite.h)

尋找媒體來源中的新位置。

語法

HRESULT SetCurrentPosition(
  [in] REFGUID        guidTimeFormat,
  [in] REFPROPVARIANT varPosition
);

參數

[in] guidTimeFormat

一個指定 時間格式的 GUID。 時間格式定義 了 varPosition 參數的單位。 以下數值對所有媒體來源定義:

價值觀 Meaning
GUID_NULL
100奈秒單位。
 

有些媒體來源可能會支持額外的數值。

[in] varPosition

播放將從哪個位置開始。 這些單位由 guidTimeFormat 參數指定。 如果 guidTimeFormat 參數是 GUID_NULL,則將變體類型設為 VT_I8

返回值

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

回傳碼 Description
S_OK
此方法已成功。
MF_E_INVALIDREQUEST
一個或多個樣本請求仍在等待中。

備註

SetCurrentPosition 方法不保證精確尋址。 搜尋的準確性取決於媒體內容。 若媒體內容包含影片串流, SetCurrentPosition 方法通常會尋找目標位置前最近的關鍵影格。 關鍵影格之間的距離取決於多種因素,包括編碼器的實作、影片內容,以及用於編碼內容的特定編碼設定。 關鍵影格之間的距離在同一影片檔案內可能會有所不同(例如,視場景複雜度而定)。

尋址完成後,應用程式應呼叫 IMFSourceReader::ReadSample ,並前進至所需位置。

若安裝了 Windows Vista 平台更新補充包,則可使用此介面。

需求

Requirement 價值觀
最低支援的用戶端 Windows 7、Windows Vista 及 Windows Vista 平台更新補充 [桌面應用程式 |UWP 應用程式]
支援的最低伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平臺 窗戶
Header mfreadwrite.h

另請參閱

IMFSourceReader

資料來源閱讀