(portcls.h) PCEVENT_ITEM 结构

  • 项目

PCEVENT_ITEM结构用于描述特定筛选器、引脚或节点支持的事件。

语法

typedef struct {
  const GUID         *Set;
  ULONG              Id;
  ULONG              Flags;
  PCPFNEVENT_HANDLER Handler;
} PCEVENT_ITEM, *PPCEVENT_ITEM;

成员

Set

指定事件集。 此成员是指向唯一标识事件集的 GUID 的指针。 请参阅 音频驱动程序事件集中的事件集 GUID 列表。

Id

指定事件 ID。 此成员标识事件集中的事件项。 如果事件集包含 N 个项，则有效的事件 ID 是介于 0 到 N-1 范围内的整数。

Flags

指定事件的类型。 此成员设置为以下值之一：

PCEVENT_ITEM_FLAG_ENABLE

指示应为此事件类型启用事件通知。 驱动程序应继续事件通知，直到客户端显式禁用它。

PCEVENT_ITEM_FLAG_ONESHOT

指示应仅为此事件的下一次出现启用事件通知。 客户端不会 (，也不应在事件发生后) 禁用事件。

PCEVENT_ITEM_FLAG_BASICSUPPORT

如果客户端指定此标志，驱动程序将返回STATUS_SUCCESS如果它支持 事件，则返回错误代码（如果不支持）。

Handler

指向微型端口驱动程序的事件处理程序例程的指针。 此成员是 PCPFNEVENT_HANDLER 类型的函数指针，定义如下：

  typedef NTSTATUS (*PCPFNEVENT_HANDLER)
  (
      IN PPCEVENT_REQUEST  EventRequest
  );

调用 Handler 例程时，调用方将传入单个调用参数，该参数是指向调用方分配 的PCEVENT_REQUEST 结构的指针。

注解

PCEVENT_ITEM 结构指定自动化表中的特定事件项。 PCAUTOMATION_TABLE 结构指向PCEVENT_ITEM结构的数组。

在 WDM 音频中，事件请求的目标为引脚实例或引脚上的节点。 筛选器实例不能是事件请求的目标。

要求

要求 值
Header portcls.h (包括 Portcls.h)

另请参阅

PCAUTOMATION_TABLE

PCEVENT_REQUEST