PHW_EVENT_ROUTINE funzione di callback (strmini.h)

Articolo
02/07/2025

Il driver di classe chiama la routine strMiniEvent del minidriver del 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 è stato abilitato correttamente o un codice di errore in caso di errore. Il driver di classe ignora il valore restituito nelle richieste di disabilitazione.

Osservazioni

Il driver di classe accoda la struttura KSEVENT_ENTRY passa EventDescriptor ->EventEntry. Ogni altro membro di EventDescriptor viene deallocato una volta StrMiniEvent, quindi tutti i dati specifici dell'evento contenuti nel EventData membro di EventDescriptor che il minidriver deve mantenere deve essere archiviato 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.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	strmini.h (include Strmini.h)

Condividi tramite