Fonction VhfReadReportSubmit (vhf.h)

Article
02/29/2024

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 à un appareil HID virtuel que votre pilote source HID a reçu lors de l’appel précédent à VhfCreate.

[in] HidTransferPacket

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

Valeur retournée

Si l’appel VhfReadReportSubmit 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 une fonction de rappel EvtVhfReadyForNextReadReport dans son appel à VhfCreate. Il doit appeler VhfReadReportSubmit une seule fois après 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.

Configuration requise

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

Voir aussi

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

Partager via