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)