Função VhfReadReportSubmit (vhf.h)

O driver de origem HID chama esse método para enviar um relatório de leitura hid (entrada) para o VHF (Virtual HID Framework).

Sintaxe

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

Parâmetros

[in] VhfHandle

Um identificador para um dispositivo HID virtual que o driver de origem HID recebeu na chamada anterior para VhfCreate.

[in] HidTransferPacket

Um ponteiro para uma estrutura HID_XFER_PACKET que descreve o relatório HID.

Retornar valor

Se a chamada VhfReadReportSubmit for bem-sucedida, o método retornará STATUS_SUCCESS. Caso contrário, um valor NTSTATUS apropriado.

Comentários

O driver de origem HID pode optar por implementar sua política de buffer ou permitir que o VHF (Virtual HID Framework) manipule o buffer.

Se o driver usar sua própria política de buffer, ele deverá implementar e registrar uma função de retorno de chamada EvtVhfReadyForNextReadReport em sua chamada para VhfCreate. Ele deve chamar VhfReadReportSubmit apenas uma vez depois que o VHF tiver invocado EvtVhfReadyForNextReadReport. Depois que o retorno de chamada tiver sido invocado, o driver poderá reutilizar o buffer de transferência apontado por HidTransferPacket. O driver deve aguardar a próxima vez que o VHF invocar EvtVhfReadyForNextReadReport antes de chamar esse método novamente.

Se o driver de origem HID não implementar o retorno de chamada EvtVhfReadyForNextReadReport , não haverá restrições para chamar esse método. O VHF usa a política de buffer padrão. O driver pode reutilizar o buffer de transferência após o retorno da chamada.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	vhf.h
Biblioteca	VhfKm.lib
IRQL	<= DISPATCH_LEVEL

Confira também

Gravar um driver de origem HID usando a VHF (Estrutura HID Virtual)