Partilhar 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. Como tal, as 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 do 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 eventos para esse tipo de evento. O driver continua a notificação de evento até que o cliente a desative explicitamente.
KSEVENT_TYPE_ONESHOT Habilita a notificação de eventos somente para a próxima ocorrência desse evento. O cliente não precisa (e não deve) desativar o evento uma vez 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 suporte de um tipo de evento específico.
KSEVENT_TYPE_ENABLEBUFFERED Em vez de notificar o cliente, o driver enfileira notificações 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. Não coloque esta bandeira por conta própria; em vez disso, OU com outras bandeiras desta lista.
KSEVENT_TYPE_QUERYBUFFER Recupera a próxima notificação de evento em buffer.

Remarks

A Microsoft fornece vários GUIDs de conjuntos 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 do kernel, consulte Propriedades, eventos e métodos do KS.

Requirements

Header: ks.h (include Ks.h)

See also

KSE_NODE

KSIDENTIFIER

KSMETHOD

KSPROPERTY