KSEVENT 구조체
KSEVENT 구조는 커널 스트리밍 이벤트 집합 내에서 단일 커널 스트리밍 이벤트를 지정합니다.
KSEVENT, KSMETHOD 및 KSPROPERTY 구조체는 KSIDENTIFIER 구조체의 별칭입니다. 따라서 해당 정의는 동일합니다.
구문
struct KSEVENT {
GUID Set;
ULONG Id;
ULONG Flags;
};
멤버
Set
커널 스트리밍 이벤트 집합을 식별하는 GUID를 지정합니다.
이벤트 집합 GUID에 대한 자세한 내용은 아래 설명 섹션을 참조하세요.
Id
이벤트 집합의 멤버를 지정합니다.
Flags
요청 유형을 지정합니다.
이 플래그는 다음 표에 나열된 값 중 하나여야 합니다.
| 값 | Description |
|---|---|
| KSEVENT_TYPE_ENABLE | 이 이벤트 유형에 대한 이벤트 알림을 사용하도록 설정합니다. 드라이버는 클라이언트가 명시적으로 사용하지 않도록 설정할 때까지 이벤트 알림을 계속합니다. |
| KSEVENT_TYPE_ONESHOT | 이 이벤트의 다음 발생에 대해서만 이벤트 알림을 사용하도록 설정합니다. 클라이언트는 이벤트가 발생한 후 이벤트를 사용하지 않도록 설정할 필요가 없으며 사용하지 않도록 설정해서는 안 됩니다. |
| KSEVENT_TYPE_SETSUPPORT | 이벤트 집합 목록 또는 특정 이벤트 집합 지원에 대한 쿼리입니다. |
| KSEVENT_TYPE_BASICSUPPORT | 특정 이벤트 형식의 지원을 위한 쿼리입니다. |
| KSEVENT_TYPE_ENABLEBUFFERED | 드라이버는 클라이언트에 알리는 대신 이벤트 알림을 큐에 대기합니다. 그런 다음 클라이언트는 큐에 대기된 이벤트 알림을 수신하기 위해 KSEVENT_TYPE_QUERYBUFFER두 번째 IOCTL_KS_ENABLE_EVENT 요청을 발급합니다. |
| KSEVENT_TYPE_TOPOLOGY | 전달된 이벤트가 KSE_NODE 형식임을 나타냅니다. 여기서 NodeId 는 토폴로지 노드의 숫자 ID를 나타냅니다. 이 플래그를 자체적으로 설정하지 마세요. 대신 이 목록의 다른 플래그와 함께 또는 입니다. |
| KSEVENT_TYPE_QUERYBUFFER | 버퍼링된 다음 이벤트 알림을 검색합니다. |
설명
Microsoft는 여러 시스템 정의 이벤트 집합 GUID를 제공합니다. 미니 드라이버는 Set 멤버에서 이러한 GUID 중 하나를 지정합니다. 커널 스트리밍 이벤트 집합은 일반적으로 KSEVENTSETID 접두사로 시작합니다. 커널 스트리밍 이벤트 집합은 ks.h, ksmedia.h, bdamedia.h 및 기타 헤더 파일로 정의됩니다.
커널 스트리밍 이벤트에 대한 자세한 내용은 KS 속성, 이벤트 및 메서드를 참조하세요.
요구 사항
헤더: ks.h(Ks.h 포함)