EVT_VHF_CLEANUP fonction de rappel (vhf.h)

Article
02/26/2024

Le pilote source HID implémente ce rappel d’événement aux ressources libres qui peuvent être le pilote alloué au périphérique HID virtuel.

Syntaxe

EVT_VHF_CLEANUP EvtVhfCleanup;

void EvtVhfCleanup(
  [in] PVOID VhfClientContext
)
{...}

Paramètres

[in] VhfClientContext

Pointeur vers la structure de contexte définie par le pilote source HID que le pilote a passée lors de l’appel précédent à VhfCreate pour créer l’appareil HID virtuel.

Valeur de retour

None

Remarques

Pour supprimer l’appareil HID virtuel, le pilote source HID appelle VhfDelete. Cet appel amène Virtual HID Framework (VHF) à appeler l’EvtVhfCleanup précédemment inscrit, si la fonction de rappel est implémentée par le pilote source HID. Lorsque le pilote appelle VhfDelete avec wait défini sur TRUE, EvtVhfCleanup est appelé avant que VhfDelete ne retourne. Si Wait a la valeur FALSE, elle peut être appelée une fois que VhfDelete est appelé avant ou après le retour de VhfDelete .

L’appel donne au pilote source HID la possibilité de libérer les ressources allouées pour l’appareil HID virtuel lors de la suppression de cet appareil.

Le pilote source HID ne doit pas utiliser le VHFHANDLE pour le périphérique HID virtuel (créé par VhfCreate) après le retour de cette fonction de rappel. Avant d’appeler cette fonction de rappel, VHF s’assure qu’aucune opération asynchrone n’est en attente.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	vhf.h
IRQL	<=DISPATCH_LEVEL

Voir aussi

Écrire un pilote source HID à l’aide de Virtual HID Framework (VHF)

Partager via