EVT_VHF_CLEANUP fonction de rappel (vhf.h)

Article
02/07/2025

Le pilote source HID implémente ce rappel d’événement pour libérer les ressources qui peuvent être allouées 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é dans l’appel précédent à VhfCreate pour créer l’appareil HID virtuel.

Valeur de retour

Aucun

Remarques

Pour supprimer l’appareil HID virtuel, le pilote source HID appelle VhfDelete. Cet appel entraîne l’appel de Virtual HID Framework (VHF) pour appeler le 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ée avant que VhfDelete retourne. Si 'attente a la valeur FALSE, il peut être appelé à tout moment après VhfDelete est appelé avant ou après VhfDelete.

L’appel donne au pilote source HID la possibilité de libérer des ressources allouées pour l’appareil HID virtuel lorsque cet appareil est supprimé.

Le pilote source HID ne doit pas utiliser le VHFHANDLE pour l’appareil HID virtuel (créé par VhfCreate) une fois cette fonction de rappel retournée. Avant d’appeler cette fonction de rappel, VHF s’assure qu’aucune opération asynchrone n’est en attente.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10
serveur minimum pris en charge	Aucun pris en charge
plateforme cible	Bureau
d’en-tête	vhf.h
IRQL	<=DISPATCH_LEVEL

Voir aussi

écrire un pilote source HID à l’aide du Virtual HID Framework (VHF)

Partager via