VhfDelete, fonction (vhf.h)

Article
02/27/2024

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

Syntaxe

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

Paramètres

[in] VhfHandle

Handle pour un appareil HID virtuel que votre pilote source HID a reçu lors de l’appel précédent à 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 au Gestionnaire PnP et que la fonction de rappel EvtVhfCleanup retourne.

FALSE est réservé et ne doit pas être passé. Pour plus d'informations, consultez la section Notes.

Valeur de retour

None

Remarques

Le pilote source HID doit cesser d’initier de nouvelles demandes 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 une fois la suppression terminée. Si le pilote source HID a inscrit une fonction de rappel EvtVhfCleanup auprès de VHF, il appelle ce rappel avant que VhfDelete ne retourne. La fonction peut être appelée sur le même thread.

VhfDelete ne peut pas être appelé de façon asynchrone (paramètre d’attente défini sur FALSE) ou à un niveau d’IRQL supérieur à PASSIVE_LEVEL. Cela peut entraîner un comportement non défini.

Il n’existe aucune restriction sur le 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 d’EvtDriverDeviceAdd, appelez VhfDelete de manière synchrone à partir d’EvtDeviceCleanupCallback. VhfDelete peut être appelé sur un VHFHANDLE sans avoir précédemment appelé VhfStart.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	vhf.h
Bibliothèque	VhfKm.lib
IRQL	Wait a la valeur TRUE, PASSIVE_LEVEL

Voir aussi

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

Partager via