KsPinGetReferenceClockInterface 函数 (ks.h)
KsPinGetReferenceClockInterface 函数将 COM 样式接口返回到与 Pin 关联的引用时钟。 此接口指针将是 IKsReferenceClock 接口。
语法
KSDDKAPI NTSTATUS KsPinGetReferenceClockInterface(
[in] PKSPIN Pin,
[out] PIKSREFERENCECLOCK *Interface
);
参数
[in] Pin
指向要为其返回引用时钟接口的 KSPIN 结构的指针。
[out] Interface
指向接收 IKsReferenceClock 接口地址的内存位置的指针。 这是一个具有关联引用计数的 COM 样式接口。 微型驱动程序在使用完接口后必须释放该接口。
返回值
如果引脚实现时钟或通过 KSPROPERTY_STREAM_MASTERCLOCK 属性收到主时钟的通知，KsPinGetReferenceClockInterface 将返回STATUS_SUCCESS并将 IKsReferenceClock 接口的地址放入 Interface 中。 如果引脚尚未收到主时钟的通知，则返回STATUS_DEVICE_NOT_READY。
注解
调用 KsPinGetReferenceClockInterface 的最常见时间是状态转换为KSSTATE_ACQUIRE。
有关使用此例程返回的 IKsReferenceClock 接口的详细信息，请参阅 AVStream 时钟。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX 中可用。 |
| 目标平台 | 通用 |
| 标头 | ks.h (包括 Ks.h) |
| Library | Ks.lib |
| IRQL | PASSIVE_LEVEL |