尋找媒體來源中的新位置。
語法
HRESULT SetCurrentPosition(
[in] REFGUID guidTimeFormat,
[in] REFPROPVARIANT varPosition
);
參數
[in] guidTimeFormat
一個指定 時間格式的 GUID。 時間格式定義 了 varPosition 參數的單位。 以下數值對所有媒體來源定義:
| 價值觀 | Meaning |
|---|---|
|
100奈秒單位。 |
有些媒體來源可能會支持額外的數值。
[in] varPosition
播放將從哪個位置開始。 這些單位由 guidTimeFormat 參數指定。 如果 guidTimeFormat 參數是 GUID_NULL,則將變體類型設為 VT_I8。
返回值
這個方法會傳回 HRESULT。 可能的值包括但不限於下表中的值。
| 回傳碼 | Description |
|---|---|
|
此方法已成功。 |
|
一個或多個樣本請求仍在等待中。 |
備註
SetCurrentPosition 方法不保證精確尋址。 搜尋的準確性取決於媒體內容。 若媒體內容包含影片串流, SetCurrentPosition 方法通常會尋找目標位置前最近的關鍵影格。 關鍵影格之間的距離取決於多種因素,包括編碼器的實作、影片內容,以及用於編碼內容的特定編碼設定。 關鍵影格之間的距離在同一影片檔案內可能會有所不同(例如,視場景複雜度而定)。
尋址完成後,應用程式應呼叫 IMFSourceReader::ReadSample ,並前進至所需位置。
若安裝了 Windows Vista 平台更新補充包,則可使用此介面。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows 7、Windows Vista 及 Windows Vista 平台更新補充 [桌面應用程式 |UWP 應用程式] |
| 支援的最低伺服器 | Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式] |
| 目標平臺 | 窗戶 |
| Header | mfreadwrite.h |