Compartilhar via


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. Dessa forma, suas definições são idênticas.

Syntax

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

Members

Set

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

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

Id

Especifica o membro do conjunto de eventos.

Flags

Especifica o tipo de solicitação.

Esse sinalizador deve ser um dos valores listados na tabela a seguir.

Value Description
KSEVENT_TYPE_ENABLE Habilita a notificação de evento para esse tipo de evento. O driver continua a notificação de evento até que o cliente a desabilite explicitamente.
KSEVENT_TYPE_ONESHOT Habilita a notificação de evento somente para a próxima ocorrência deste evento. O cliente não precisa (e não deve) desabilitar o evento depois que ele ocorreu.
KSEVENT_TYPE_SETSUPPORT Consultas para a lista de conjuntos de eventos ou para suporte de um conjunto de eventos específico.
KSEVENT_TYPE_BASICSUPPORT Consultas para obter suporte de um tipo de evento específico.
KSEVENT_TYPE_ENABLEBUFFERED Em vez de notificar o cliente, o driver enfileira as notificações de evento. 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. Não defina esse sinalizador por conta própria; em vez disso, OU com outros sinalizadores desta lista.
KSEVENT_TYPE_QUERYBUFFER Recupera a próxima notificação de evento em buffer.

Remarks

A Microsoft fornece vários GUIDs de conjunto de eventos definidos pelo 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 obter mais informações sobre eventos de streaming de kernel, consulte Propriedades, Eventos e Métodos do KS.

Requirements

Header: ks.h (include Ks.h)

See also

KSE_NODE

KSIDENTIFIER

KSMETHOD

KSPROPERTY