PCPFNEVENT_HANDLER funzione di callback (portcls.h)
Una EventHandler routine elabora le richieste di eventi.
Sintassi
PCPFNEVENT_HANDLER PcpfneventHandler;
NTSTATUS PcpfneventHandler(
[in] PPCEVENT_REQUEST EventRequest
)
{...}
Parametri
[in] EventRequest
Puntatore a una struttura di PCEVENT_REQUEST inizializzata
Valore restituito
Il gestore eventi restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato.
Commenti
Ogni evento esposto da un driver miniport è associato a un gestore eventi. Lo scopo del gestore eventi è elaborare le richieste di eventi dal driver di porta e dai relativi client. EventRequest è un parametro di input per il gestore che contiene le informazioni seguenti sull'evento:
- GUID del set di eventi e ID evento.
- Modalità di attivazione dell'evento.
- Puntatori all'oggetto miniport di destinazione e (per un pin) oggetto flusso.
Il driver miniport espone i gestori eventi tramite il metodo IMiniport::GetDescription . Questo metodo restituisce una struttura del descrittore (vedere PCFILTER_DESCRIPTOR) che definisce il filtro che il driver miniport e il driver di porta associato implementano insieme. Questa struttura contiene un puntatore alla tabella di automazione del driver miniport (vedere PCAUTOMATION_TABLE), che a sua volta contiene un puntatore a una matrice degli eventi del driver miniport. Ogni elemento di matrice è una struttura PCEVENT_ITEM e contiene un puntatore a funzione PCPFNEVENT_HANDLER al gestore per l'evento.
La EventHandler routine deve risiedere nella memoria non in pagine.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | portcls.h (include Portcls.h) |
Vedi anche
IPortEvents::AddEventToEventList