KSEVENT_ITEM 结构 (ks.h)

  • 项目

KSEVENT_ITEM 结构描述微型驱动程序对事件集中特定事件的支持。

语法

typedef struct {
  ULONG            EventId;
  ULONG            DataInput;
  ULONG            ExtraEntryData;
  PFNKSADDEVENT    AddHandler;
  PFNKSREMOVEEVENT RemoveHandler;
  PFNKSHANDLER     SupportHandler;
} KSEVENT_ITEM, *PKSEVENT_ITEM;

成员

EventId

指定事件集中事件的唯一 ID。

DataInput

指定事件数据的大小（以字节为单位）。 事件数据以 KSEVENTDATA 结构开头，该结构描述在事件发生时应如何通知客户端，后跟指定事件发生时间的任何其他参数（可选）。 大小必须至少 为 (KSEVENTDATA) 。

ExtraEntryData

指定系统应为此事件的每个启用请求分配的任何其他内存的大小（以字节为单位）。 驱动程序使用此内存来存储跟踪事件请求所需的任何数据。 内存直接在事件启用请求的 KSEVENT_ENTRY 结构之后分配。

AddHandler

指向微型驱动程序提供的 AVStrMiniAddEvent 回调例程的指针。 流类驱动程序不使用。 仅适用于 AVStream 微型驱动程序。

RemoveHandler

指向微型驱动程序提供的 AVStrMiniRemoveEvent 回调例程的指针。 流类驱动程序不使用。 仅适用于 AVStream 微型驱动程序。

SupportHandler

流类驱动程序不使用。

注解

指定 AddHandler 和 RemoveHandler 成员且未正确清理事件的微型驱动程序可能会导致资源 (内存/句柄) 泄漏。

要求

要求 值
Header ks.h (包括 Ks.h)

另请参阅

IOCTL_KS_DISABLE_EVENT

KSEVENTDATA

KSEVENT_ENTRY

KsDefaultAddEventHandler