KsGenerateEvent-Funktion (ks.h)
Die KsGenerateEvent-Funktion generiert bei einer Ereigniseintragsstruktur eine Standardereignisbenachrichtigung.
Syntax
KSDDKAPI NTSTATUS KsGenerateEvent(
[in] PKSEVENT_ENTRY EventEntry
);
Parameter
[in] EventEntry
Gibt die Ereigniseintragsstruktur an, die auf die Ereignisdaten verweist. Die Informationen werden verwendet, um zu bestimmen, welche Art von Benachrichtigung ausgeführt werden soll. Wenn der Benachrichtigungstyp keiner der vordefinierten Standards ist, wird ein Fehler zurückgegeben. Im Falle eines einzelnen, nicht wiederkehrenden Ereignisses ist dieser Eintrag ungültig, wenn er von der Funktion zurückgegeben wird. Daher muss jeder Code, der eine Liste von Ereignissen aufzählt, vorab erhöht werden, um das nächste Ereignis in der Liste zu erhalten, bevor dieses Ereignis an die Funktion übergeben wird.
Rückgabewert
Die KsGenerateEvent-Funktion gibt STATUS_SUCCESS zurück, wenn sie erfolgreich ist, oder wenn sie nicht erfolgreich ist, gibt sie eine Ausnahme oder einen Speicherfehler zurück.
Hinweise
Ein Gerät bestimmt, wann Ereignisbenachrichtigungen mithilfe der KSEVENT_ENTRY-Struktur generiert werden, und verwendet dann diese Funktion, um die tatsächliche Benachrichtigung auszuführen. KsGenerateEvent kann in jedem IRQL aufgerufen werden. Wenn oben DISPATCH_LEVEL aufgerufen wird, erfolgt die Signalisierung des Ereignisses asynchron in einem DPC.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | ks.h (ks.h einschließen) |
| Bibliothek | Ks.lib |
| IRQL | Beliebige Ebene (siehe Abschnitt "Hinweise") |