PHW_EVENT_ROUTINE fonction de rappel (strmini.h)

Article
02/07/2025

Le pilote de classe appelle la routine StrMiniEvent du flux pour signaler à un minidriver qu’un événement doit être activé ou désactivé.

Syntaxe

PHW_EVENT_ROUTINE PhwEventRoutine;

NTSTATUS PhwEventRoutine(
  [in] IN PHW_EVENT_DESCRIPTOR EventDescriptor
)
{...}

Paramètres

[in] EventDescriptor

Décrit l’événement et indique s’il doit être activé ou désactivé.

Valeur de retour

Pour les événements d’activation d’événement, StrMiniEvent retourne STATUS_SUCCESS si l’événement est activé avec succès ou un code d’erreur en cas d’échec. Le pilote de classe ignore la valeur de retour sur les demandes de désactivation.

Remarques

Le pilote de classe met en file d’attente la structure KSEVENT_ENTRY qu’elle transmet dans EventDescriptor ->EventEntry. Tous les autres membres de EventDescriptor sont désalloués une fois StrMiniEvent s’arrête, de sorte que toutes les données spécifiques aux événements contenues dans le membre EventData de EventDescriptor que le minidriver doit conserver doit être stocké par le minidriver.

À cet effet, le minidriver peut allouer de l’espace directement après la structure KSEVENT_ENTRY en fournissant une valeur différente de zéro dans l'Membre extraEntryData de la structure KSEVENT_ITEM utilisée pour déclarer l’événement.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	strmini.h (include Strmini.h)

Partager via