PHW_EVENT_ROUTINE Rückruffunktion (strmini.h)

Artikel
02/26/2024

Der Klassentreiber ruft die StrMiniEvent-Routine des Stream-Minitreibers auf, um einem Minitreiber zu signalisieren, dass ein Ereignis aktiviert oder deaktiviert werden soll.

Syntax

PHW_EVENT_ROUTINE PhwEventRoutine;

NTSTATUS PhwEventRoutine(
  [in] IN PHW_EVENT_DESCRIPTOR EventDescriptor
)
{...}

Parameter

[in] EventDescriptor

Beschreibt das Ereignis und ob es aktiviert oder deaktiviert werden soll.

Rückgabewert

StrMiniEvent gibt für Ereignisaktivierte Ereignisse STATUS_SUCCESS zurück, wenn das Ereignis erfolgreich aktiviert wurde, oder einen Fehlercode bei Einem Fehler. Der Klassentreiber ignoriert den Rückgabewert bei Deaktivierungsanforderungen.

Hinweise

Der Klassentreiber stellt die KSEVENT_ENTRY Struktur in die Warteschlange, die er in EventDescriptor-EventEntry> übergibt. Alle anderen Member von EventDescriptor werden aufgehoben, sobald StrMiniEvent beendet wird. Daher sollten alle ereignisspezifischen Daten, die im EventData-Member von EventDescriptor enthalten sind und die der Minitreiber beibehalten muss, vom Minitreiber gespeichert werden.

Zu diesem Zweck kann der Minidriver speicherplatz direkt nach der KSEVENT_ENTRY-Struktur zuordnen, indem er im ExtraEntryData-Member der KSEVENT_ITEM Struktur, die zum Deklarieren des Ereignisses verwendet wurde, einen Wert ungleich 0 (null) bereitstellt.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	strmini.h (include Strmini.h)

Freigeben über