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 结构开头,该结构描述在事件发生时应如何通知客户端,(可选)后跟指定事件发生时的任何其他参数。 必须至少 sizeof(KSEVENTDATA)。

ExtraEntryData

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

AddHandler

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

RemoveHandler

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

SupportHandler

流类驱动程序不使用。

言论

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

要求

要求 价值
标头 ks.h (包括 Ks.h)

另请参阅

IOCTL_KS_DISABLE_EVENT

KSEVENTDATA

KSEVENT_ENTRY

KsDefaultAddEventHandler