VhfReadReportSubmit, fonction (vhf.h)

Article
02/07/2025

Le pilote source HID appelle cette méthode pour envoyer un rapport HID Read (Input) à Virtual HID Framework (VHF).

Syntaxe

NTSTATUS VhfReadReportSubmit(
  [in] VHFHANDLE        VhfHandle,
  [in] PHID_XFER_PACKET HidTransferPacket
);

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] HidTransferPacket

Pointeur vers une structure HID_XFER_PACKET qui décrit le rapport HID.

Valeur de retour

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

Remarques

Le pilote source HID peut choisir d’implémenter sa stratégie de mise en mémoire tampon ou de laisser Virtual HID Framework (VHF) gérer la mise en mémoire tampon.

Si le pilote utilise sa propre stratégie de mise en mémoire tampon, il doit implémenter et inscrire un EvtVhfReadyForNextReadReport fonction de rappel dans son appel à VhfCreate. Il doit appeler VhfReadReportSubmit une seule fois que VHF a appelé EvtVhfReadyForNextReadReport. Une fois le rappel appelé, le pilote peut réutiliser la mémoire tampon de transfert pointée par HidTransferPacket. Le pilote doit attendre la prochaine fois que VHF appelle EvtVhfReadyForNextReadReport avant d’appeler à nouveau cette méthode.

Si le pilote source HID n’implémente pas le rappel EvtVhfReadyForNextReadReport, il n’existe aucune restriction sur l’appel de cette méthode. VHF utilise la stratégie de mise en mémoire tampon par défaut. Le pilote peut réutiliser la mémoire tampon de transfert après le retour de l’appel.

Exigences

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

Voir aussi

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

Partager via