VhfReadReportSubmit 函数 (vhf.h)
HID 源驱动程序调用此方法将 HID 读取 (输入) 报告提交到虚拟 HID 框架 (VHF) 。
语法
NTSTATUS VhfReadReportSubmit(
[in] VHFHANDLE VhfHandle,
[in] PHID_XFER_PACKET HidTransferPacket
);
参数
[in] VhfHandle
HID 源驱动程序在上一次调用 VhfCreate 时收到的虚拟 HID 设备的句柄。
[in] HidTransferPacket
指向描述 HID 报表 的HID_XFER_PACKET 结构的指针。
返回值
如果 VhfReadReportSubmit 调用成功，该方法将返回STATUS_SUCCESS。 否则为相应的 NTSTATUS 值。
注解
HID 源驱动程序可以选择实现其缓冲策略，或者让虚拟 HID 框架 (VHF) 处理缓冲。
如果驱动程序使用自己的缓冲策略，则必须在调用 VhfCreate 时实现并注册 EvtVhfReadyForNextReadReport 回调函数。 在 VHF 调用 EvtVhfReadyForNextReadReport 之后，它必须调用 VhfReadReportSubmit 一次。 调用回调后，驱动程序可以重复使用 HidTransferPacket 指向的传输缓冲区。 在再次调用此方法之前，驱动程序必须等待 VHF 下次调用 EvtVhfReadyForNextReadReport 。
如果 HID 源驱动程序未实现 EvtVhfReadyForNextReadReport 回调，则调用此方法没有限制。 VHF 使用默认缓冲策略。 调用返回后，驱动程序可以重复使用传输缓冲区。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | vhf.h |
| Library | VhfKm.lib |
| IRQL | <= DISPATCH_LEVEL |