Функция VhfReadReportSubmit (vhf.h)

Статья
02/07/2025

Драйвер источника HID вызывает этот метод для отправки отчета HID read (input) в Virtual HID Framework (VHF).

Синтаксис

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

Параметры

[in] VhfHandle

Дескриптор виртуального устройства HID, полученного драйвером источника HID в предыдущем вызове VhfCreate.

[in] HidTransferPacket

Указатель на структуру HID_XFER_PACKET, описывающую отчет HID.

Возвращаемое значение

Если вызов VhfReadReportSubmit выполнен, метод возвращает STATUS_SUCCESS. В противном случае соответствующее значение NTSTATUS.

Замечания

Исходный драйвер HID может реализовать свою политику буферизации или разрешить буферизации Virtual HID Framework (VHF).

Если драйвер использует собственную политику буферизации, он должен реализовать и зарегистрировать функцию обратного вызова EvtVhfReadyForNextReadReport в вызове VhfCreate. Он должен вызывать VhfReadReportSubmit только один раз после вызова EvtVhfReadyForNextReadReport. После вызова обратного вызова драйвер может повторно использовать буфер передачи, на который указывает HidTransferPacket. Драйвер должен ожидать следующего вызова VHF EvtVhfReadyForNextReadReport перед повторным вызовом этого метода.

Если драйвер источника HID не реализует обратный вызов EvtVhfReadyForNextReadReport обратного вызова, то нет ограничений на вызов этого метода. VHF использует политику буферизации по умолчанию. Драйвер может повторно использовать буфер передачи после возврата вызова.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	vhf.h
библиотеки	VhfKm.lib
IRQL	<= DISPATCH_LEVEL

См. также

Написание исходного драйвера HID с помощью Virtual HID Framework (VHF)

Поделиться через