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

См. также раздел

KsFilterAddEvent

KsFilterGenerateEvents

KsPinAddEvent

KsPinGenerateEvents