PCPFNEVENT_HANDLER Rückruffunktion (portcls.h)

Artikel
02/07/2025

Ein EventHandler Routine verarbeitet Ereignisanforderungen.

Syntax

PCPFNEVENT_HANDLER PcpfneventHandler;

NTSTATUS PcpfneventHandler(
  [in] PPCEVENT_REQUEST EventRequest
)
{...}

Parameter

[in] EventRequest

Zeiger auf eine initialisierte PCEVENT_REQUEST-Struktur

Rückgabewert

Der Ereignishandler gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben.

Bemerkungen

Jedes Ereignis, das ein Miniporttreiber verfügbar macht, ist einem Ereignishandler zugeordnet. Der Zweck des Ereignishandlers besteht darin, Ereignisanforderungen vom Porttreiber und seinen Clients zu verarbeiten. EventRequest ist ein Eingabeparameter für den Handler, der die folgenden Informationen zum Ereignis enthält:

Die GUID und Ereignis-ID des Ereignissatzes.
Wie das Ereignis ausgelöst werden soll.
Zeiger auf das Ziel-Miniportobjekt und (für ein Pin)-Datenstromobjekt.

Dies ähnelt dem Informationstyp, der mit Eigenschaftsanforderungen bereitgestellt wird.

Der Miniporttreiber macht seine Ereignishandler über die IMiniport::GetDescription--Methode verfügbar. Diese Methode gibt eine Deskriptorstruktur (siehe PCFILTER_DESCRIPTOR) aus, die den Filter definiert, den der Miniporttreiber und der zugehörige Porttreiber zusammen implementieren. Diese Struktur enthält einen Zeiger auf die Automatisierungstabelle des Miniporttreibers (siehe PCAUTOMATION_TABLE), die wiederum einen Zeiger auf ein Array der Miniporttreiberereignisse enthält. Jedes Arrayelement ist eine PCEVENT_ITEM Struktur und enthält einen PCPFNEVENT_HANDLER Funktionszeiger auf den Handler für das Ereignis.

Die EventHandler Routine muss sich im nicht seitenfreien Speicher befinden.