Funzione VhfReadReportSubmit (vhf.h)

Articolo
02/07/2025

Il driver di origine HID chiama questo metodo per inviare un report HID Read (Input) a Virtual HID Framework (VHF).

Sintassi

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

Parametri

[in] VhfHandle

Handle per un dispositivo HID virtuale ricevuto dal driver di origine HID nella chiamata precedente a VhfCreate.

[in] HidTransferPacket

Puntatore a una struttura HID_XFER_PACKET che descrive il report HID.

Valore restituito

Se il VhfReadReportSubmit chiamata ha esito positivo, il metodo restituisce STATUS_SUCCESS. In caso contrario, un valore NTSTATUS appropriato.

Osservazioni

Il driver di origine HID può scegliere di implementare i criteri di buffering o consentire a Virtual HID Framework (VHF) di gestire il buffering.

Se il driver usa i propri criteri di buffering, deve implementare e registrare un EvtVhfReadyForNextReadReport funzione di callback nella chiamata a VhfCreate. Deve chiamare VhfReadReportSubmit una sola volta dopo che VHF ha richiamato EvtVhfReadyForNextReadReport. Dopo aver richiamato il callback, il driver può riutilizzare il buffer di trasferimento a cui punta HidTransferPacket. Il driver deve attendere la volta successiva che VHF richiama EvtVhfReadyForNextReadReport prima di chiamare di nuovo questo metodo.

Se il driver di origine HID non implementa l'EvtVhfReadyForNextReadReport callback, non sono previste restrizioni per la chiamata a questo metodo. VHF usa i criteri di buffering predefiniti. Il driver può riutilizzare il buffer di trasferimento dopo la restituzione della chiamata.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	vhf.h
libreria	VhfKm.lib
IRQL	<= DISPATCH_LEVEL

Vedere anche

scrivere un driver di origine HID usando VHF (Virtual HID Framework)

Condividi tramite