KsPinGetReferenceClockInterface 函式 (ks.h)

發行項
02/26/2024

KsPinGetReferenceClockInterface 函式會將 COM 樣式介面傳回與 Pin 相關聯的參考時鐘。這個介面指標會是 IKsReferenceClock 介面。

語法

KSDDKAPI NTSTATUS KsPinGetReferenceClockInterface(
  [in]  PKSPIN             Pin,
  [out] PIKSREFERENCECLOCK *Interface
);

參數

[in] Pin

要傳回參考時鐘介面之 KSPIN 結構的指標。

[out] Interface

接收 IKsReferenceClock 介面地址的記憶體位置指標。這是具有相關聯參考計數的 COM 樣式介面。 Minidrivers 必須在介面完成時釋出介面。

傳回值

如果針腳實作時鐘或已透過 KSPROPERTY_STREAM_MASTERCLOCK 屬性收到主時鐘的通知，KsPinGetReferenceClockInterface 會傳回STATUS_SUCCESS，並將 IKsReferenceClock 介面的地址儲存到 Interface。如果針腳尚未收到主時鐘的通知，則傳回STATUS_DEVICE_NOT_READY。

備註

呼叫 KsPinGetReferenceClockInterface 最常見的時間是狀態轉換至KSSTATE_ACQUIRE。

如需使用此例程所傳回之 IKsReferenceClock 介面的詳細資訊，請參閱 AVStream 時鐘。

規格需求

需求	值
最低支援的用戶端	適用於 Microsoft Windows XP 和更新版本的作業系統和 DirectX 8.0 和更新版本的 DirectX。
目標平台	Universal
標頭	ks.h (包含 Ks.h)
程式庫	Ks.lib
IRQL	PASSIVE_LEVEL