PHW_EVENT_ROUTINE funzione di callback (strmini.h)
Il driver di classe chiama la routine StrMiniEvent del minidriver di flusso per segnalare a un minidriver un evento deve essere abilitato o disabilitato.
Sintassi
PHW_EVENT_ROUTINE PhwEventRoutine;
NTSTATUS PhwEventRoutine(
[in] IN PHW_EVENT_DESCRIPTOR EventDescriptor
)
{...}
Parametri
[in] EventDescriptor
Descrive l'evento e se deve essere abilitato o disabilitato.
Valore restituito
Per gli eventi di abilitazione degli eventi, StrMiniEvent restituisce STATUS_SUCCESS se l'evento è abilitato correttamente o un codice di errore in caso di errore. Il driver di classe ignora il valore restituito nelle richieste di disabilitazione.
Commenti
Il driver di classe accoda la struttura KSEVENT_ENTRY passata in EventDescriptor-EventEntry>. Ogni altro membro di EventDescriptor viene deallocato dopo l'uscita da StrMiniEvent , quindi tutti i dati specifici dell'evento contenuti nel membro EventData di EventDescriptor che il minidriver deve conservare devono essere archiviati dal minidriver.
A tale scopo, il minidriver può allocare spazio direttamente dopo la struttura KSEVENT_ENTRY fornendo un valore diverso da zero nel membro ExtraEntryData della struttura KSEVENT_ITEM utilizzata per dichiarare l'evento.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Desktop |
Intestazione | strmini.h (include Strmini.h) |