通过

VhfReadReportSubmit 函数 （vhf.h）

  • 项目

HID 源驱动程序调用此方法，将 HID 读取（输入）报告提交到虚拟 HID 框架（VHF）。

语法

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

参数

[in] VhfHandle

HID 源驱动程序在上一次调用中收到的虚拟 HID 设备的句柄，VhfCreate。

[in] HidTransferPacket

指向描述 HID 报表的 HID_XFER_PACKET 结构的指针。

返回值

如果 VhfReadReportSubmit 调用成功，该方法将返回STATUS_SUCCESS。 否则，NTSTATUS 值。

言论

HID 源驱动程序可以选择实现其缓冲策略，或让虚拟 HID 框架（VHF）处理缓冲。

如果驱动程序使用自己的缓冲策略，则必须在调用 VhfCreate中实现并注册 EvtVhfReadyForNextReadReport 回调函数。 在 VHF 调用 EvtVhfReadyForNextReadReport后，它必须仅调用 VhfReadSubmit 一次。 调用回调后，驱动程序可以重复使用 HidTransferPacket指向的传输缓冲区。 在再次调用此方法之前，驱动程序必须等待 VHF 下次调用 EvtVhfReadyForNextReadReport。

如果 HID 源驱动程序未实现 EvtVhfReadyForNextReadReport 回调，则调用此方法没有限制。 VHF 使用默认缓冲策略。 驱动程序可以在调用返回后重复使用传输缓冲区。

要求

要求 价值
目标平台 窗户
标头 vhf.h
库 VhfKm.lib
IRQL <= DISPATCH_LEVEL

另请参阅

使用虚拟 HID 框架（VHF） 编写 HID 源驱动程序