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
Microsoft는 여러 시스템 정의 이벤트 집합 GUID를 제공합니다. 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)