PHW_EVENT_ROUTINE fonction de rappel (strmini.h)

Article
02/26/2024

Le pilote de classe appelle la routine StrMiniEvent du minidriver de 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 s’il doit être activé ou désactivé.

Valeur retournée

Pour les événements d’activation d’événement, StrMiniEvent retourne STATUS_SUCCESS si l’événement est correctement activé, 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’il transmet dans EventDescriptor-EventEntry>. Tous les autres membres d’EventDescriptor sont désalloués une fois StrMiniEvent terminé. Par conséquent, toutes les données spécifiques à l’événement contenues dans le membre EventDatad’EventDescriptor que le minidriver doit conserver doivent être stockées par le minidriver.

À cette fin, le minidriver peut allouer de l’espace directement après la structure KSEVENT_ENTRY en fournissant une valeur différente de zéro dans le membre ExtraEntryData de la structure KSEVENT_ITEM qu’il a utilisée pour déclarer l’événement.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	strmini.h (include Strmini.h)

Partager via