Funzione KsGenerateEvent (ks.h)
La funzione KsGenerateEvent genera una notifica evento standard data una struttura di immissione eventi.
Sintassi
KSDDKAPI NTSTATUS KsGenerateEvent(
[in] PKSEVENT_ENTRY EventEntry
);
Parametri
[in] EventEntry
Specifica la struttura della voce di evento che fa riferimento ai dati dell'evento. Le informazioni vengono usate per determinare il tipo di notifica da eseguire. Se il tipo di notifica non è uno degli standard predefiniti, viene restituito un errore. Nel caso di un singolo evento non ricorsiva, questa voce non sarà valida per la restituzione dalla funzione. Pertanto, qualsiasi codice che enumera un elenco di eventi deve preincrement per acquisire l'evento successivo nell'elenco prima di passare questo evento alla funzione.
Valore restituito
La funzione KsGenerateEvent restituisce STATUS_SUCCESS se ha esito positivo o se ha esito negativo restituisce un errore di eccezione o memoria.
Commenti
Un dispositivo determina quando le notifiche degli eventi vengono generate usando la struttura KSEVENT_ENTRY , quindi usa questa funzione per eseguire la notifica effettiva. KsGenerateEvent può essere chiamato in qualsiasi IRQL. Se viene chiamato sopra DISPATCH_LEVEL, la segnalazione dell'evento verrà eseguita in modo asincrono in un DPC.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Universale |
Intestazione | ks.h (include Ks.h) |
Libreria | Ks.lib |
IRQL | Qualsiasi livello (vedere la sezione Osservazioni) |