KsCreateDefaultClock 函数 (ks.h)
给定IRP_MJ_CREATE请求, KsCreateDefaultClock 函数会创建一个默认时钟,该时钟使用系统时钟作为时间基,并使用内部调度表 (KSDISPATCH_TABLE) 将 IoGetCurrentIrpStackLocation (Irp) -FileObject> 与时钟相关联。 不完成 IRP 或在 IRP 中设置状态。
KsCreateDefaultClock 函数只能在PASSIVE_LEVEL调用。
语法
KSDDKAPI NTSTATUS KsCreateDefaultClock(
[in] PIRP Irp,
[in] PKSDEFAULTCLOCK DefaultClock
);
参数
[in] Irp
指定正在处理时钟创建请求的 IRP。
[in] DefaultClock
指定在父级默认时钟的任何实例之间共享的初始化默认时钟结构。
返回值
如果成功, KsCreateDefaultClock 函数返回STATUS_SUCCESS;如果失败,则返回错误。
注解
可以在使用 KsAllocateDefaultClock 创建和初始化默认时钟实例的内部结构之后创建时钟。 初始化后,可以针对同一基础默认时钟实例创建许多文件对象。
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
标头 | ks.h (包括 Ks.h) |
Library | Ks.lib |