KsAllocateDefaultClock 函数 (ks.h)

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

语法

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

[out] DefaultClock

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

如果成功， KsAllocateDefaultClock 函数返回STATUS_SUCCESS;如果失败，则返回内存错误。

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

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