Función VhfReadReportSubmit (vhf.h)

El controlador de origen HID llama a este método para enviar un informe de lectura (entrada) HID a Virtual HID Framework (VHF).

Sintaxis

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

Parámetros

[in] VhfHandle

Identificador de un dispositivo HID virtual que el controlador de origen HID recibió en la llamada anterior a VhfCreate.

[in] HidTransferPacket

Puntero a una estructura de HID_XFER_PACKET que describe el informe HID.

Valor devuelto

Si la llamada VhfReadReportSubmit se realiza correctamente, el método devuelve STATUS_SUCCESS. De lo contrario, un valor NTSTATUS adecuado.

Comentarios

El controlador de origen HID puede optar por implementar su directiva de almacenamiento en búfer o permitir que Virtual HID Framework (VHF) controle el almacenamiento en búfer.

Si el controlador usa su propia directiva de almacenamiento en búfer, debe implementar y registrar una función de devolución de llamada EvtVhfReadyForNextReadReport en su llamada a VhfCreate. Debe llamar a VhfReadReportSubmit solo una vez después de que VHF haya invocado EvtVhfReadyForNextReadReport. Una vez invocada la devolución de llamada, el controlador puede reutilizar el búfer de transferencia al que apunta HidTransferPacket. El controlador debe esperar la próxima vez que VHF invoque EvtVhfReadyForNextReadReport antes de llamar a este método de nuevo.

Si el controlador de origen HID no implementa la devolución de llamada EvtVhfReadyForNextReadReport , no hay ninguna restricción al llamar a este método. VHF usa la directiva de almacenamiento en búfer predeterminada. El controlador puede reutilizar el búfer de transferencia después de que se devuelva la llamada.

Requisitos

Consulte también

Escribir un controlador de origen HID mediante Virtual HID Framework (VHF)