Структура KSEVENT

Статья
06/15/2023

Структура KSEVENT указывает одно событие потоковой передачи ядра в наборе событий потоковой передачи ядра.

Структуры KSEVENT, KSMETHOD и KSPROPERTY являются псевдонимами для структуры KSIDENTIFIER . Таким образом, их определения идентичны.

Синтаксис

struct KSEVENT {
  GUID Set;
  ULONG Id;
  ULONG Flags;
};

Члены

Set

Указывает GUID, идентифицирующий набор событий потоковой передачи ядра.

Дополнительные сведения о идентификаторах GUID набора событий см. в разделе Примечания ниже.

Id

Указывает член набора событий.

Flags

Указывает тип запроса.

Этот флаг должен быть одним из значений, перечисленных в следующей таблице.

Значение	Описание
KSEVENT_TYPE_ENABLE	Включает уведомление о событиях этого типа. Драйвер продолжает уведомлять о событиях, пока клиент явно не отключит его.
KSEVENT_TYPE_ONESHOT	Включает уведомление о событиях только для следующего вхождения этого события. Клиенту не нужно (и не следует) отключать событие после его возникновения.
KSEVENT_TYPE_SETSUPPORT	Запрашивает список наборов событий или поддержку определенного набора событий.
KSEVENT_TYPE_BASICSUPPORT	Запросы на поддержку определенного типа событий.
KSEVENT_TYPE_ENABLEBUFFERED	Вместо уведомления клиента драйвер помещает в очередь уведомления о событиях. Затем клиент отправляет второй запрос IOCTL_KS_ENABLE_EVENT с KSEVENT_TYPE_QUERYBUFFER для получения уведомлений о событиях в очереди.
KSEVENT_TYPE_TOPOLOGY	Указывает, что переданное событие имеет тип KSE_NODE, где NodeId обозначает числовой идентификатор узла топологии. Не устанавливайте этот флаг самостоятельно; вместо этого или с другими флагами из этого списка.
KSEVENT_TYPE_QUERYBUFFER	Извлекает следующее уведомление о событии в буфере.

Корпорация Майкрософт предоставляет несколько идентификаторов GUID набора событий, определяемых системой. Мини-накопители указывают один из этих идентификаторов GUID в элементе Set . Наборы событий потоковой передачи ядра обычно начинаются с префикса KSEVENTSETID . Наборы событий потоковой передачи ядра определяются в файлах ks.h, ksmedia.h, bdamedia.h и, возможно, в других файлах заголовков.

Дополнительные сведения о событиях потоковой передачи ядра см. в разделе Свойства, события и методы KS.