Función VhfReadReportSubmit (vhf.h)

El controlador de origen HID llama a este método para enviar un informe de lectura de HID (entrada) 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 HID_XFER_PACKET que describe el informe HID.

Valor devuelto

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

Observaciones

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 un EvtVhfReadyForNextReadReport función de devolución de llamada 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 el EvtVhfReadyForNextReadReport devolución de llamada, no hay restricciones 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

Requisito	Valor
de la plataforma de destino de	Windows
encabezado de	vhf.h
biblioteca de	VhfKm.lib
irQL	<= DISPATCH_LEVEL

Consulte también

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