(portcls.h) 的PCPFNEVENT_HANDLER回调函数

项目
02/27/2024

例 EventHandler 程处理事件请求。

语法

PCPFNEVENT_HANDLER PcpfneventHandler;

NTSTATUS PcpfneventHandler(
  [in] PPCEVENT_REQUEST EventRequest
)
{...}

参数

[in] EventRequest

指向已初始化 PCEVENT_REQUEST 结构的指针

返回值

如果调用成功，事件处理程序将返回STATUS_SUCCESS。否则，它将返回相应的错误代码。

注解

微型端口驱动程序公开的每个事件都与事件处理程序相关联。事件处理程序的目的是处理来自端口驱动程序及其客户端的事件请求。 EventRequest 是处理程序的输入参数，其中包含有关事件的以下信息：

事件集 GUID 和事件 ID。
如何触发事件。
指向目标微型端口对象的指针，以及固定) 流对象的 (。

这类似于属性请求中提供的信息类型。

微型端口驱动程序通过其 IMiniport：：GetDescription 方法公开其事件处理程序。此方法输出描述符结构 (请参阅 PCFILTER_DESCRIPTOR 定义微型端口驱动程序及其关联端口驱动程序共同实现的筛选器的) 。此结构包含指向微型端口驱动程序的自动化表的指针， (查看 PCAUTOMATION_TABLE) ，后者又包含指向微型端口驱动程序事件数组的指针。每个数组元素都是一个 PCEVENT_ITEM 结构，包含指向事件处理程序的PCPFNEVENT_HANDLER函数指针。

例 EventHandler 程必须驻留在非分页内存中。