VhfReadReportSubmit 函式 (vhf.h)

  • 發行項

HID 來源驅動程式會呼叫此方法，將 HID 讀取 (輸入) 報表提交至虛擬 HID Framework (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 Framework (VHF) 處理緩衝處理。

如果驅動程式使用自己的緩衝原則，則必須在其對 VhfCreate 的呼叫中實作並註冊 EvtVhfReadyForNextReadReport 回呼函式。 它必須在 VHF 叫用 EvtVhfReadyForNextReadReport 之後，才呼叫 VhfReadReportSubmit 一次。 叫用回呼之後，驅動程式可以重複使用 HidTransferPacket 所指向的傳輸緩衝區。 驅動程式下次必須等候 VHF 叫用 EvtVhfReadyForNextReadReport ，再再次呼叫此方法。

如果 HID 來源驅動程式未實作 EvtVhfReadyForNextReadReport 回呼，則呼叫此方法沒有任何限制。 VHF 使用默認緩衝原則。 驅動程式可以在呼叫傳回之後重複使用傳輸緩衝區。

規格需求

需求 值
目標平台 Windows
標頭 vhf.h
程式庫 VhfKm.lib
IRQL <= DISPATCH_LEVEL

另請參閱

使用虛擬 HID Framework (VHF) 撰寫 HID 來源驅動程式