IReferenceClock::AdviseTime 方法
[與此頁面相關聯的功能 Windows Media Format 11 SDK是舊版功能。 來源讀取器和接收寫入器已取代它。 來源讀取器和接收寫入器已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用來源讀取器和接收寫入器,而不是Windows Media Format 11 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼,以使用新的 API。]
建議時間方法會要求經過時間的非同步通知。
語法
HRESULT AdviseTime(
[in] REFERENCE_TIME rtBaseTime,
[in] REFERENCE_TIME rtStreamTime,
[in] HEVENT hEvent,
[out] DWORD *pdwAdviseCookie
);
參數
-
rtBaseTime [in]
-
以 100 奈秒為單位的基底參考時間。
-
rtStreamTime [in]
-
資料流程位移時間,以 100 奈秒為單位。
-
hEvent [in]
-
呼叫端所建立之事件的控制碼。 此事件會在指定的時間經過時發出訊號。
-
pdwAdviseCookie [out]
-
接收要求識別碼之變數的指標。 例如,這會用來識別未來 對 AdviseTime 的這個呼叫,以取消要求。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
傳回碼 | 描述 |
---|---|
|
此方法已成功。 |
|
pdwAdviseCookie參數為Null。 |
|
未指定的失敗。 |