Compartir a través de


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. Por lo tanto, sus definiciones son idénticas.

Syntax

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

Members

Set

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

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

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.

Value Description
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 ha 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. 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. No establezca esta marca por sí sola; en su lugar, OR con otras marcas de esta lista.
KSEVENT_TYPE_QUERYBUFFER Recupera la siguiente notificación de eventos almacenados en búfer.

Remarks

Microsoft proporciona varios GUID de conjunto de eventos definidos por el sistema. 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.

Para obtener más información sobre los eventos de streaming de kernel, consulte propiedades, eventos y métodos de KS.

Requirements

Header: ks.h (include Ks.h)

See also

KSE_NODE

KSIDENTIFIER

KSMETHOD

KSPROPERTY