IMediaSeeking::GetDuration 方法 (strmif.h)

[與此頁面相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayerIMFMediaEngine音訊/視訊擷取 ,而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式代碼盡可能重寫為使用新的 API。

GetDuration 方法會取得數據流的持續時間。

語法

HRESULT GetDuration(
  [out] LONGLONG *pDuration
);

參數

[out] pDuration

以目前時間格式單位接收持續時間。

傳回值

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

這個方法會以正常播放速度取得數據流的持續時間。 變更播放速率不會影響持續時間。

持續時間是以目前的時間格式表示。 默認時間格式REFERENCE_TIME單位 ( 100 奈秒) 。 若要變更時間格式,請使用 IMediaSeeking::SetTimeFormat 方法。

視來源格式而定,持續時間可能不精確。 例如,如果來源包含可變比特率 (VBR) 數據流,則方法可能會傳回估計的持續時間。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 strmif.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

錯誤和成功碼

IMediaSeeking 介面