通过

PCEVENT_ITEM结构（portcls.h）

  • 项目

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
  );

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

言论

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

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

要求

要求 价值
标头 portcls.h （包括 Portcls.h）

另请参阅

PCAUTOMATION_TABLE

PCEVENT_REQUEST