Share via

IMFSourceReader：：SetCurrentPosition 方法 (mfreadwrite.h)

  • 發行項

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

語法

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

參數

[in] guidTimeFormat

指定 時間格式的 GUID。 時間格式會定義 varPosition 參數的單位。 下列值會針對所有媒體來源定義：

值 意義
GUID_NULL
 100 奈秒單位。
 

某些媒體來源可能支援其他值。

[in] varPosition

開始播放的位置。 單位是由 guidTimeFormat 參數所指定。 如果 guidTimeFormat 參數 GUID_NULL，請將 variant 類型設定為 VT_I8。

傳回值

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

傳回碼 Description
S_OK
 此方法已成功。
MF_E_INVALIDREQUEST
 一或多個範例要求仍在擱置中。

備註

SetCurrentPosition 方法不保證確實搜尋。 搜尋的精確度取決於媒體內容。 如果媒體內容包含視訊數據流， SetCurrentPosition 方法通常會在所需位置之前搜尋最接近的主要畫面格。 主要畫面格之間的距離取決於數個因素，包括編碼器實作、視訊內容，以及用來編碼內容的特定編碼設定。 主要畫面格之間的距離在單一視訊檔案內可能會有所不同 (，例如視場景複雜度) 而定。

搜尋之後，應用程式應該呼叫 IMFSourceReader：：ReadSample 並前進到所需的位置。

如果已安裝適用於 Windows Vista 的平臺更新補充，則此介面可在 Windows Vista 上使用。

規格需求

需求 值
最低支援的用戶端 適用於 Windows Vista 的 Windows 7、Windows Vista 和平臺更新補充 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 mfreadwrite.h

另請參閱

IMFSourceReader

來源讀取器