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 使用默认缓冲策略。 调用返回后，驱动程序可以重复使用传输缓冲区。

要求

另请参阅

使用虚拟 HID 框架 (VHF) 编写 HID 源驱动程序