KsPinGetReferenceClockInterface 函式 (ks.h)
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 |