Функция 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
Используется для синхронизации доступа к элементу в списке. Блокировка берется перед перечислением списка и освобождается после перечисления.
Возвращаемое значение
None
Remarks
Эту функцию можно вызвать на любом уровне IRQL, если это разрешено механизмом блокировки.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Верхняя часть | ks.h (включая Ks.h) |
| Библиотека | Ks.lib |
| IRQL | Любой уровень (см. раздел "Примечания") |