VhfCreate, fonction (vhf.h)

Article
02/07/2025

Le pilote source HID appelle cette méthode pour créer un périphérique HID virtuel.

Syntaxe

NTSTATUS VhfCreate(
  [in]  PVHF_CONFIG VhfConfig,
  [out] VHFHANDLE   *VhfHandle
);

Paramètres

[in] VhfConfig

Pointeur vers une structure VHF_CONFIG.

[out] VhfHandle

Handle vers le nouvel appareil HID virtuel.

Valeur de retour

Si l’appel VhfCreate réussit, la méthode retourne STATUS_SUCCESS. Sinon, une valeur NTSTATUS appropriée .

Remarques

Cette méthode retourne de façon synchrone après avoir validé la structure VHF_CONFIG et créé un appareil HID virtuel. L’appareil HID virtuel est signalé uniquement à PnP. L’initialisation, l’installation et le démarrage de l’appareil peuvent ne pas se terminer avant que cette méthode ne retourne.

Un pilote KMDF (Kernel-Mode Driver Framework) peut appeler VhfCreate à tout moment après avoir créé son propre objet d’appareil en appelant WdfDeviceCreate. Le pilote peut le faire dans son EvtDriverDeviceAdd, EvtDevicePrepareHardware, EvtDeviceD0Entry, EvtDeviceSelfManagedIoInit.

VHF n’appelle pas de fonctions de rappel spécifiées dans VHF_CONFIG jusqu’à ce que le pilote source HID appelle VhfStart.

Exigences

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

Voir aussi

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

Partager via