KsGenerateEvent 函数 (ks.h)

KsGenerateEvent 函数在给定事件条目结构的情况下生成标准事件通知。

语法

KSDDKAPI NTSTATUS KsGenerateEvent(
  [in] PKSEVENT_ENTRY EventEntry
);

[in] EventEntry

指定引用事件数据的事件条目结构。该信息用于确定要执行的通知类型。如果通知类型不是预定义标准之一，则返回错误。对于单个非递归事件，此条目在从函数返回时无效。因此，枚举事件列表的任何代码都必须预先递增以获取列表中的下一个事件，然后再将此事件传递给函数。

如果成功， KsGenerateEvent 函数将返回STATUS_SUCCESS;如果失败，则返回异常或内存错误。

设备使用 KSEVENT_ENTRY 结构确定何时生成事件通知，然后使用此函数执行实际通知。可以在任何 IRQL 中调用 KsGenerateEvent。如果调用上述DISPATCH_LEVEL，则事件信号将在 DPC 中异步执行。