PHW_EVENT_ROUTINE回调函数 (strmini.h)
类驱动程序调用流微型驱动程序的 StrMiniEvent 例程,以向微型驱动程序发出信号,应启用或禁用事件。
语法
PHW_EVENT_ROUTINE PhwEventRoutine;
NTSTATUS PhwEventRoutine(
[in] IN PHW_EVENT_DESCRIPTOR EventDescriptor
)
{...}
参数
[in] EventDescriptor
描述事件,以及它是否应启用或禁用。
返回值
对于事件启用事件,StrMiniEvent 在成功启用事件或失败时返回错误代码STATUS_SUCCESS。 类驱动程序忽略禁用请求的返回值。
言论
类驱动程序将它传入 EventDescriptor->EventEntry中的 KSEVENT_ENTRY 结构排入队列。 StrMiniEvent 退出后,EventDescriptor 的所有其他成员都会解除分配,因此 EventData 成员中包含的任何特定于事件的数据 EventDescriptor 的成员 微型驱动程序应由微型驱动程序存储。
为此,微型驱动程序可以直接在KSEVENT_ENTRY结构之后分配空间,方法是在用于声明事件的 KSEVENT_ITEM 结构的 ExtraEntryData 成员中提供非零值。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | strmini.h (包括 Strmini.h) |