Функция VhfReadReportSubmit (vhf.h)
Драйвер источника 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)