KSEVENT 구조체

아티클
02/07/2024

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 속성, 이벤트 및 메서드를 참조하세요.