KsPinGetReferenceClockInterface 函数 (ks.h)

KsPinGetReferenceClockInterface 函数将 COM 样式接口返回到与 Pin关联的引用时钟。 此接口指针将是 IKsReferenceClock 接口。

语法

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

参数

[in] Pin

指向 KSPIN 结构的指针,用于返回引用时钟接口。

[out] Interface

指向接收 IKsReferenceClock 接口地址的内存位置的指针。 这是具有关联引用计数的 COM 样式接口。 微型驱动程序在使用完接口后必须释放该接口。

返回值

KsPinGetReferenceClockInterface 返回STATUS_SUCCESS,并将 IKsReferenceClock 接口的地址存储在 接口(如果引脚实现时钟或通过 KSPROPERTY_STREAM_MASTERCLOCK 属性收到主时钟通知)。 如果引脚尚未收到主时钟通知,则返回STATUS_DEVICE_NOT_READY。

言论

调用 KsPinGetReferenceClockInterface 最常见的时间是在状态转换到KSSTATE_ACQUIRE。

有关使用此例程返回的 IKsReferenceClock 接口的详细信息,请参阅 AVStream 时钟

要求

要求 价值
最低支持的客户端 Microsoft Windows XP 及更高版本的作系统以及 DirectX 8.0 及更高版本的 DirectX 版本中提供。
目标平台 普遍
标头 ks.h (包括 Ks.h)
Ks.lib
IRQL PASSIVE_LEVEL

另请参阅

IKsControl

IKsReferenceClock

KsFilterGetOuterUnknown

KsGetOuterUnknown

KsPinGetConnectedFilterInterface

KsPinGetConnectedPinInterface

KsPinSetPinClockTime

KsRegisterAggregatedClientUnknown