IMFPresentationTimeSource::GetUnderlyingClock 方法 (mfidl.h)

擷取表示時間來源用來產生其時鐘時間的基礎時鐘。

語法

HRESULT GetUnderlyingClock(
  [out] IMFClock **ppClock
);

參數

[out] ppClock

接收時鐘 之 IMFClock 介面的指標。 呼叫端必須釋放 介面。

傳回值

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

傳回碼 描述
S_OK
此方法已成功。
MF_E_NO_CLOCK
這個時間來源不會公開基礎時鐘。

備註

簡報時間來源必須支援停止、啟動、暫停和速率變更。 不過,在許多情況下,時間來源會從硬體時鐘或其他裝置衍生其時鐘時間。 基礎時鐘一律執行,而且可能不支援速率變更。

或者,時間來源可以藉由實作此方法來公開基礎時鐘。 基礎時鐘一律會執行,即使簡報時間來源已暫停或停止也一樣。 (因此,基礎時鐘會傳回 IMFClock::GetClockCharacteristics 方法) 中的 MFCLOCK_CHARACTERISTICS_FLAG_ALWAYS_RUNNING 旗標。

如果您想要在簡報時鐘停止或暫停時,根據時鐘時間做出決策,基礎時鐘就很有用。

如果時間來源未公開基礎時鐘,方法會傳回MF_E_NO_CLOCK。

規格需求

需求
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 mfidl.h
程式庫 Mfuuid.lib

另請參閱

IMFPresentationTimeSource

簡報時鐘