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)