Funzione KsGenerateEvent (ks.h)
La funzione KsGenerateEvent genera una notifica di evento standard in base a una struttura di immissione di eventi.
Sintassi
KSDDKAPI NTSTATUS KsGenerateEvent(
[in] PKSEVENT_ENTRY EventEntry
);
Parametri
[in] EventEntry
Specifica la struttura di immissione di eventi che fa riferimento ai dati dell'evento. Le informazioni vengono utilizzate 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 noncurring, questa voce non sarà valida per la restituzione dalla funzione. Pertanto, qualsiasi codice che enumera un elenco di eventi deve preincrementare per acquisire l'evento successivo nell'elenco prima di passare questo evento alla funzione.
Valore restituito
La funzione KsGenerateEvent restituisce STATUS_SUCCESS in caso di esito positivo o se ha esito negativo restituisce un'eccezione o un errore di memoria.
Osservazioni
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 in precedenza DISPATCH_LEVEL, la segnalazione dell'evento verrà eseguita in modo asincrono in un DPC.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | ks.h (include Ks.h) |
| libreria | Ks.lib |
| IRQL | Qualsiasi livello (vedere la sezione Osservazioni) |