PHW_EVENT_ROUTINE Rückruffunktion (strmini.h)

Artikel
02/07/2025

Der Klassentreiber ruft die StrMiniEvent-Routine des Stream-Minidrivers auf, um einem Minidriver 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

Für Ereignisaktive Ereignisse gibt StrMiniEvent- STATUS_SUCCESS zurück, wenn das Ereignis erfolgreich aktiviert wurde, oder fehlercode bei Einem Fehler. Der Klassentreiber ignoriert den Rückgabewert für deaktivierte Anforderungen.

Bemerkungen

Der Klassentreiber stellt die KSEVENT_ENTRY Struktur in die Warteschlange, die er übergibt, in EventDescriptor-->EventEntry. Jedes andere Mitglied von EventDescriptor- wird nach dem Beenden StrMiniEvent behandelt, sodass alle ereignisspezifischen Daten, die im EventData Mitglied von EventDescriptor enthalten sind,, dass der Minidriver vom Minidriver gespeichert werden muss.

Zu diesem Zweck kann der Minidriver direkt nach der KSEVENT_ENTRY Struktur Platz zuordnen, indem ein Wert ungleich Null im ExtraEntryData Member der KSEVENT_ITEM Struktur bereitgestellt wird, die zum Deklarieren des Ereignisses verwendet wird.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	strmini.h (einschließlich Strmini.h)

Freigeben über