Функция KsGenerateEventList (ks.h)

Статья
02/07/2025

Функция 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 (include Ks.h)
библиотеки	Ks.lib
IRQL	Любой уровень (см. раздел "Примечания")

См. также

Поделиться через