Funzione VhfReadReportSubmit (vhf.h)

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 la chiamata VhfReadReportSubmit ha esito positivo, il metodo restituisce STATUS_SUCCESS. In caso contrario, un valore NTSTATUS appropriato.

Commenti

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 una funzione di callback EvtVhfReadyForNextReadReport nella chiamata a VhfCreate. Deve chiamare VhfReadReportSubmit solo una 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 il callback EvtVhfReadyForNextReadReport , 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.

Requisiti

Vedi anche

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