VhfDelete, fonction (vhf.h)

Le pilote de périphérique SOURCE HID appelle cette méthode pour supprimer un périphérique VHF.

Syntaxe

void VhfDelete(
  [in] VHFHANDLE VhfHandle,
  [in] BOOLEAN   Wait
);

Paramètres

[in] VhfHandle

Handle vers un périphérique HID virtuel que votre pilote source HID a reçu lors de l’appel précédent pour VhfCreate.

[in] Wait

TRUE pour retourner de façon synchrone après la suppression d’un appareil. Dans ce cas, Virtual HID Framework (VHF) ne retourne pas tant que l’appareil n’est pas signalé comme manquant dans PnP Manager et EvtVhfCleanup fonction de rappel retourne.

FALSE est réservé et ne doit pas être passé. Pour plus d’informations, consultez les remarques.

Valeur de retour

Aucun

Remarques

Le pilote source HID doit cesser de lancer de nouvelles requêtes pour virtual HID Framework (VHF) juste avant d’appeler VhfDelete.

Pour appeler VhfDelete de manière synchrone, appelez-le à PASSIVE_LEVEL avec le paramètre Wait défini sur TRUE. Dans ce cas, elle retourne de façon synchrone après avoir terminé la suppression. Si le pilote source HID a inscrit une fonction de rappel EvtVhfCleanup avec VHF, elle appelle ce rappel avant VhfDelete. La fonction peut être appelée sur le même thread.

VhfDelete ne peut pas être appelée de manière asynchrone (paramètre Wait défini sur FALSE) ou à un irQL supérieur à PASSIVE_LEVEL. Cela peut entraîner un comportement non défini.

Il n’existe aucune restriction quant au moment où un pilote KMDF doit appeler cette fonction. Il est recommandé de l’appeler à partir d’une fonction correspondant à l’appel VhfCreate. Par exemple, si VhfCreate est appelé à partir de EvtDriverDeviceAdd, appelez VhfDelete de manière synchrone à partir de EvtDeviceCleanupCallback. VhfDelete peut être appelé sur un VHFHANDLE sans avoir précédemment appelé VhfStart .

Exigences

Exigence	Valeur
plateforme cible	Windows
d’en-tête	vhf.h
bibliothèque	VhfKm.lib
IRQL	Wait is TRUE, PASSIVE_LEVEL

Voir aussi

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