Struttura KSEVENT

Articolo
06/15/2023

La struttura KSEVENT specifica un singolo evento di streaming del kernel all'interno di un set di eventi di streaming del kernel.

Le strutture KSEVENT, KSMETHOD e KSPROPERTY sono alias per la struttura KSIDENTIFIER . Di conseguenza, le definizioni sono identiche.

Sintassi

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

Members

Set

Specifica un GUID che identifica un set di eventi di streaming del kernel.

Per altre informazioni sui GUID del set di eventi, vedere la sezione Osservazioni di seguito.

Id

Specifica il membro del set di eventi.

Flags

Specifica il tipo di richiesta.

Questo flag deve essere uno dei valori elencati nella tabella seguente.

Valore	Descrizione
KSEVENT_TYPE_ENABLE	Abilita la notifica degli eventi per questo tipo di evento. Il driver continua la notifica degli eventi fino a quando il client non lo disabilita in modo esplicito.
KSEVENT_TYPE_ONESHOT	Abilita la notifica degli eventi solo per l'occorrenza successiva di questo evento. Il client non deve (e non deve) disabilitare l'evento dopo che si è verificato.
KSEVENT_TYPE_SETSUPPORT	Query per l'elenco di set di eventi o per il supporto di un determinato set di eventi.
KSEVENT_TYPE_BASICSUPPORT	Query per il supporto di un particolare tipo di evento.
KSEVENT_TYPE_ENABLEBUFFERED	Invece di inviare una notifica al client, il driver accoda le notifiche degli eventi. Il client invia quindi una seconda richiesta di IOCTL_KS_ENABLE_EVENT con il KSEVENT_TYPE_QUERYBUFFER per ricevere le notifiche degli eventi in coda.
KSEVENT_TYPE_TOPOLOGY	Indica che l'evento passato è di tipo KSE_NODE, dove NodeId indica l'ID numerico del nodo della topologia. Non impostare questo flag autonomamente; in alternativa, OPPURE con altri flag da questo elenco.
KSEVENT_TYPE_QUERYBUFFER	Recupera la notifica successiva degli eventi memorizzati nel buffer.

Commenti

Microsoft fornisce diversi GUID del set di eventi definiti dal sistema. I minidriver specificano uno di questi GUID nel membro Set . I set di eventi di streaming del kernel iniziano in genere con un prefisso KSEVENTSETID . I set di eventi di streaming del kernel sono definiti in ks.h, ksmedia.h, bdamedia.h ed eventualmente altri file di intestazione.

Per altre informazioni sugli eventi di streaming del kernel, vedere Proprietà, eventi e metodi KS.