KsAllocateDefaultClock 函数（ks.h）

KsAllocateDefaultClock 函数分配并初始化默认时钟结构。

语法

KSDDKAPI NTSTATUS KsAllocateDefaultClock(
  [out] PKSDEFAULTCLOCK *DefaultClock
);

[out] DefaultClock

指定调用方分配的共享默认时钟结构。当前时间设置为零，状态设置为KSSTATE_STOP。成功完成此例程后，此指针指示的结构将包含对默认时钟的引用。返回的数据应被视为不透明，并保留以供系统使用。

KsAllocateDefaultClock 函数返回STATUS_SUCCESS（如果成功）或内存错误（如果失败）。

内部 DefaultClock.ReferenceCount 元素由 KsAllocateDefaultClock 函数初始化为一个。元素递增并递减，因为每个通知 DPC 已排队并完成。当结构被释放时，该元素用于确定时钟的所有者是否应释放结构，或者挂起的 DPC 是否应异步释放它。

不再需要时钟时，驱动程序必须调用 KsFreeDefaultClock 来释放分配用于时钟的任何资源。