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结构排队。 EventDescriptor 的所有其他成员在 StrMiniEvent 退出后将被解除分配,因此,微型驱动程序应存储 EventDescriptor 的 EventData 成员中包含的任何特定于事件的数据。
为此,微型驱动程序可以通过在用于声明事件的 KSEVENT_ITEM 结构的 ExtraEntryData 成员中提供非零值,直接在 KSEVENT_ENTRY 结构之后分配空间。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | strmini.h (包括 Strmini.h) |