KsGenerateDataEvent 函数 (ks.h)

如果给定事件条目结构和回调数据， KsGenerateDataEvent 函数将生成其中一个标准事件通知。这允许设备确定何时应生成事件通知，但仍使用此帮助程序函数执行实际通知。

语法

KSDDKAPI NTSTATUS KsGenerateDataEvent(
  [in] PKSEVENT_ENTRY EventEntry,
  [in] ULONG          DataSize,
  [in] PVOID          Data
);

[in] EventEntry

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

[in] DataSize

指定传递 的数据 参数的大小（以字节为单位）。

[in] Data

指向要传递给客户端回调的数据。此数据将复制到启用事件时设置的预分配缓冲区槽之一。数据的大小必须小于最初分配的数据大小，否则事件将失败。

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

假定在调用此函数之前已获取事件列表锁。此函数可能导致调用事件条目的 RemoveHandler 。因此，不能在高于锁的 IRQ 级别调用函数，或者 Remove 函数必须能够处理在此类 IRQ 级别调用的函数。

此函数专门用于通过回调将数据传递回客户端的事件。