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)