KsGenerateEventList 函数 (ks.h)

KsGenerateEventList 函数枚举事件列表并搜索要生成的指定事件。

语法

KSDDKAPI VOID KsGenerateEventList(
  [in, optional] GUID              *Set,
  [in]           ULONG             EventId,
  [in]           PLIST_ENTRY       EventsList,
  [in]           KSEVENTS_LOCKTYPE EventsFlags,
  [in]           PVOID             EventsLock
);

参数

[in, optional] Set

指定要生成的事件的可选集。 如果存在,则此值与列表中每个事件的设置标识符进行比较。 如果不存在,则忽略设置标识符,并且仅在比较中用于列表中的匹配事件的特定事件标识符。 当已知所有事件都包含在单个集中时,此比较可节省时间。

[in] EventId

指定要在列表中查找的特定事件标识符。

[in] EventsList

指向可找到事件的KSEVENT_ENTRY项列表的头。

[in] EventsFlags

指定用于访问事件列表的排除锁类型的 KSEVENTS_LOCKTYPE 标志。 如果未设置任何标志,则不执行锁定。

[in] EventsLock

用于同步对列表上元素的访问。 锁定是在枚举列表之前获取的,并在枚举后释放。

返回值

没有

言论

如果锁定机制允许此函数,则可以在任何 IRQL 级别调用此函数。

要求

要求 价值
目标平台 普遍
标头 ks.h (包括 Ks.h)
Ks.lib
IRQL 任何级别 (请参阅“备注”部分)

另请参阅

KsFilterAddEvent

KsFilterGenerateEvents

KsPinAddEvent

KsPinGenerateEvents