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) |
| Library | Ks.lib |
| IRQL | 任何级别 (请参阅备注部分) |