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


KSEVENT structure

The KSEVENT structure specifies a single kernel streaming event within a kernel streaming event set.

The KSEVENT, KSMETHOD, and KSPROPERTY structures are aliases for the KSIDENTIFIER structure. Таким образом, их определения идентичны.

Syntax

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

Members

Set

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

For more information about event set GUIDs, see the Remarks section below.

Id

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

Flags

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

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

Value Description
KSEVENT_TYPE_ENABLE Включает уведомление о событии для этого типа события. Драйвер продолжает уведомление о событии, пока клиент явно не отключает его.
KSEVENT_TYPE_ONESHOT Включает уведомление о событии только для следующего вхождения этого события. Клиент не должен (и не должен) отключать событие после его возникновения.
KSEVENT_TYPE_SETSUPPORT Запросы к списку наборов событий или для поддержки определенного набора событий.
KSEVENT_TYPE_BASICSUPPORT Запросы на поддержку определенного типа события.
KSEVENT_TYPE_ENABLEBUFFERED Вместо уведомления клиента уведомления о событиях в очереди драйверов. The client then issues a second IOCTL_KS_ENABLE_EVENT request with the KSEVENT_TYPE_QUERYBUFFER to receive the queued event notifications.
KSEVENT_TYPE_TOPOLOGY Indicates that the event passed is of type KSE_NODE, where NodeId indicates the numeric ID of the topology node. Не устанавливайте этот флаг самостоятельно; вместо этого или с другими флагами из этого списка.
KSEVENT_TYPE_QUERYBUFFER Извлекает следующее буферизованное уведомление о событии.

Remarks

Корпорация Майкрософт предоставляет несколько системных идентификаторов идентификаторов идентификаторов событий. Minidrivers specify one of these GUIDs in the Set member. Kernel streaming event sets typically begin with a KSEVENTSETID prefix. Kernel streaming event sets are defined in ks.h, ksmedia.h, bdamedia.h, and possibly other header files.

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

Requirements

Header: ks.h (include Ks.h)

See also

KSE_NODE

KSIDENTIFIER

KSMETHOD

KSPROPERTY