StreamClassGetNextEvent-Funktion (strmini.h)

Artikel
02/07/2025

Minidriver können die StreamClassGetNextEvent Routine verwenden, um die Ereigniswarteschlange eines Geräts oder eines bestimmten Datenstroms zu durchsuchen.

Syntax

PKSEVENT_ENTRY StreamClassGetNextEvent(
  [in, optional] PVOID             HwInstanceExtension_OR_HwDeviceExtension,
  [in, optional] PHW_STREAM_OBJECT HwStreamObject,
  [in, optional] GUID              *EventGuid,
  [in]           ULONG             EventItem,
  [in, optional] PKSEVENT_ENTRY    CurrentEvent
);

Parameter

[in, optional] HwInstanceExtension_OR_HwDeviceExtension

Zeiger auf die Geräteerweiterung des Minidrivers. Der Minidriver gibt die Größe dieses Puffers in der HW_INITIALIZATION_DATA Struktur an, die er übergibt, wenn er sich über StreamClassRegisterMinidriverregistriert. Der Klassentreiber übergibt dann Zeiger an den Puffer in der HwDeviceExtension Member des HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXTund PORT_CONFIGURATION_INFORMATION Strukturen, die an den Minidriver übergeben werden.

Dieser erste Parameter war PVOID HwDeviceExtension. Es MUSS HwInstanceExtension für Multiinstanz- und Multifiltertypen (Version 20) sein. Ältere Treiber für einzelne Instanzen können weiterhin HwDeviceExtension als ersten Parameter angeben. Sie kann auch HwInstanceExtension angeben.

[in, optional] HwStreamObject

Zeiger auf eine HW_STREAM_OBJECT. Legen Sie den Wert auf NULL- fest, um die Ereigniswarteschlange des Geräts selbst zu durchsuchen. Um die Ereigniswarteschlange eines bestimmten Datenstroms zu durchsuchen, legen Sie es auf das Streamobjekt des Datenstroms fest.

[in, optional] EventGuid

Gibt das Ereignis an, das beim Durchlaufen der Warteschlange übereinstimmen soll, oder gibt NULL- an, um einem beliebigen Ereignissatz zu entsprechen.

[in] EventItem

Gibt die Ereignis-ID an, die beim Durchlaufen der Warteschlange übereinstimmen soll, oder -1, um einem Ereignis zu entsprechen.

[in, optional] CurrentEvent

Zeiger auf ein Ereignis in der Ereigniswarteschlange oder NULL-.

Rückgabewert

Wenn CurrentEvent- nicht NULL-ist, gibt StreamClassGetNextEvent das nächste übereinstimmende Ereignis zurück, nachdem CurrentEvent- in der Warteschlange (oder NULL-, wenn kein solches nächstes Ereignis vorhanden ist). Wenn CurrentEvent-NULL-ist, gibt StreamClassGetNextEvent das erste übereinstimmende Ereignis in der Warteschlange zurück.

Bemerkungen

Der Minidriver kann StreamClassGetNextEvent- aufrufen, um eine Schleife in der Ereigniswarteschlange durchzuführen und gleichzeitig ein Ereignis zu untersuchen.

Der Aufrufer kann zusätzliche Suchkriterien angeben, die Ereignissen in der Ereigniswarteschlange entsprechen sollen.

Anforderungen

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

Freigeben über