Estructura KSEVENT

Artículo
06/15/2023

La estructura KSEVENT especifica un único evento de streaming de kernel dentro de un conjunto de eventos de streaming de kernel.

Las estructuras KSEVENT, KSMETHOD y KSPROPERTY son alias para la estructura KSIDENTIFIER . Por lo tanto, sus definiciones son idénticas.

Sintaxis

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

Miembros

Set

Especifica un GUID que identifica un conjunto de eventos de streaming de kernel.

Para obtener más información sobre los GUID del conjunto de eventos, vea la sección Comentarios a continuación.

Id

Especifica el miembro del conjunto de eventos.

Flags

Especifica el tipo de solicitud.

Esta marca debe ser uno de los valores enumerados en la tabla siguiente.

Valor	Descripción
KSEVENT_TYPE_ENABLE	Habilita la notificación de eventos para este tipo de evento. El controlador continúa la notificación de eventos hasta que el cliente la deshabilita explícitamente.
KSEVENT_TYPE_ONESHOT	Habilita la notificación de eventos solo para la siguiente aparición de este evento. El cliente no necesita (y no debe) deshabilitar el evento una vez que se haya producido.
KSEVENT_TYPE_SETSUPPORT	Consulta la lista de conjuntos de eventos o para admitir un conjunto de eventos determinado.
KSEVENT_TYPE_BASICSUPPORT	Consultas para admitir un tipo de evento determinado.
KSEVENT_TYPE_ENABLEBUFFERED	En lugar de notificar al cliente, el controlador pone en cola las notificaciones de eventos. A continuación, el cliente emite una segunda solicitud IOCTL_KS_ENABLE_EVENT con el KSEVENT_TYPE_QUERYBUFFER para recibir las notificaciones de eventos en cola.
KSEVENT_TYPE_TOPOLOGY	Indica que el evento pasado es de tipo KSE_NODE, donde NodeId indica el identificador numérico del nodo de topología. No establezca esta marca por sí sola; en su lugar, O bien con otras marcas de esta lista.
KSEVENT_TYPE_QUERYBUFFER	Recupera la siguiente notificación de eventos almacenados en búfer.

Comentarios

Microsoft proporciona varios GUID de conjunto de eventos definidos por el sistema. Los minidrivers especifican uno de estos GUID en el miembro Set . Los conjuntos de eventos de streaming de kernel suelen comenzar con un prefijo KSEVENTSETID . Los conjuntos de eventos de streaming de kernel se definen en ks.h, ksmedia.h, bdamedia.h y, posiblemente, en otros archivos de encabezado.

Para obtener más información sobre los eventos de streaming de kernel, vea Propiedades de KS, Eventos y Métodos.