共用方式為

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 Framework （VHF） 處理緩衝處理。

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

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

要求

要求 價值
目標平臺 窗戶
標頭 vhf.h
連結庫 VhfKm.lib
IRQL <= DISPATCH_LEVEL

另請參閱

使用虛擬 HID 架構 （VHF） 撰寫 HID 來源驅動程式