KsGenerateEvent 函数 (ks.h)

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

语法

KSDDKAPI NTSTATUS KsGenerateEvent(
  [in] PKSEVENT_ENTRY EventEntry
);

参数

[in] EventEntry

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

返回值

KsGenerateEvent 函数返回STATUS_SUCCESS(如果成功)或失败,则返回异常或内存错误。

言论

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

要求

要求 价值
目标平台 普遍
标头 ks.h (包括 Ks.h)
Ks.lib
IRQL 任何级别 (请参阅“备注”部分)

另请参阅

KsFilterAddEvent

KsFilterGenerateEvents

KsPinAddEvent

KsPinGenerateEvents