IKsReferenceClock 介面（ks.h）

2025-02-07

IKsReferenceClock 介面是 AVStream 在所有針腳上提供的 COM 樣式介面。針腳會將要求傳遞至主時鐘。

遺產

IKsReferenceClock 介面繼承自 IUnknown 介面。

方法

IKsReferenceClock 介面具有這些方法。


IKsReferenceClock：：GetCorrelatedPhysicalTime IKsReferenceClock：：GetCorrelatedPhysicalTime 方法會查詢目前實體時間的相關參考時鐘，並擷取相互關聯的系統時間。
IKsReferenceClock：：GetCorrelatedTime IKsReferenceClock：：GetCorrelatedTime 方法會查詢目前數據流時間的相關參考時鐘，並取得相互關聯的系統時間。
IKsReferenceClock：：GetPhysicalTime IKsReferenceClock：：GetPhysicalTime 方法會查詢目前實體時間的相關參考時鐘。
IKsReferenceClock：：GetResolution IKsReferenceClock：：GetResolution 方法會查詢相關聯的參考時鐘以取得其解析度。
IKsReferenceClock：：GetState IKsReferenceClock：：GetState 方法會查詢相關聯的參考時鐘，以取得其目前串流狀態。
IKsReferenceClock：：GetTime IKsReferenceClock：：GetTime 方法會查詢目前時間的相關參考時鐘。

言論

minidriver 可以藉由呼叫 KsPinGetReferenceClockInterface來取得 IKsReferenceClock 介面。因為這是 COM 樣式介面，KsPinGetReferenceClockInterface 會呼叫 QueryInterface，進而叫用 addRef 以遞增介面指標。這表示當 minidriver 完成 IKsReferenceClock 介面時，minidriver 必須呼叫 Release來釋放它。

以 C 撰寫的用戶端會將 IKsReferenceClock 介面視為結構，其中包含函式數據表的指標，而不是C++抽象基類。以 C++ 撰寫的用戶端可能會執行下列動作：

PIKSREFERENCECLOCK RefClock;

if (NT_SUCCESS (
  KsPinGetReferenceClockInterface (
    Pin,
    &RefClock)
) {
    ... RefClock -> GetCorrelatedTime (...);
    RefClock -> Release ();
}

不過，以 C 撰寫的用戶端會改為執行下列動作：

PIKSREFERENCECLOCK RefClock;

If (NT_SUCCESS (
  KsPinGetReferenceClockInterface (
    Pin,
    &RefClock)
) {
  ... RefClock -> lpVtbl -> GetCorrelatedTime (...);
  RefClock -> lpVtbl -> Release ();
}

如需詳細資訊，請參閱 AVStream 概觀。