VhfCreate, fonction (vhf.h)

Article
03/01/2024

Le pilote source HID appelle cette méthode pour créer un appareil 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 du nouvel appareil HID virtuel.

Valeur retournée

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

Remarques

Cette méthode retourne de manière synchrone après la validation de la structure VHF_CONFIG et la création d’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 le retour de cette méthode.

Un pilote KMDF (Driver Framework) Kernel-Mode 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 aucune fonction de rappel spécifiée dans VHF_CONFIG tant que le pilote source HID n’appelle pas VhfStart.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	vhf.h
Bibliothèque	VhfKm.lib
IRQL	PASSIVE_LEVEL

Voir aussi

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

Partager via