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

Статья
03/08/2023

Драйвер источника HID вызывает этот метод для отправки отчета HID Read (Input) в Виртуальную платформу HID (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 .

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

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

Требования

Требование	Значение
Целевая платформа	Windows
Header	vhf.h
Библиотека	VhfKm.lib
IRQL	<= DISPATCH_LEVEL

См. также раздел

Создание исходного драйвера HID с помощью Виртуальной платформы HID (VHF)

Share via