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) |