Fungsi VhfReadReportSubmit (vhf.h)

  • Artikel

Driver sumber HID memanggil metode ini untuk mengirimkan Laporan Baca (Input) HID ke Virtual HID Framework (VHF).

Sintaks

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

Parameter

[in] VhfHandle

Handel ke perangkat HID virtual yang diterima driver sumber HID Anda di panggilan sebelumnya ke VhfCreate.

[in] HidTransferPacket

Penunjuk ke struktur HID_XFER_PACKET yang menjelaskan laporan HID.

Nilai kembali

Jika panggilan VhfReadReportSubmit berhasil, metode mengembalikan STATUS_SUCCESS. Jika tidak, nilai NTSTATUS yang sesuai.

Keterangan

Driver sumber HID dapat memilih untuk menerapkan kebijakan buffering-nya atau membiarkan Virtual HID Framework (VHF) menangani buffering.

Jika driver menggunakan kebijakan buffering sendiri, maka driver harus menerapkan dan mendaftarkan fungsi panggilan balik EvtVhfReadyForNextReadReport dalam panggilannya ke VhfCreate. Ini harus memanggil VhfReadReportSubmit hanya sekali setelah VHF memanggil EvtVhfReadyForNextReadReport. Setelah panggilan balik dipanggil, driver dapat menggunakan kembali buffer transfer yang ditujukan oleh HidTransferPacket. Driver harus menunggu saat berikutnya VHF memanggil EvtVhfReadyForNextReadReport sebelum memanggil metode ini lagi.

Jika driver sumber HID tidak menerapkan panggilan balik EvtVhfReadyForNextReadReport , maka tidak ada batasan untuk memanggil metode ini. VHF menggunakan kebijakan buffering default. Driver dapat menggunakan kembali buffer transfer setelah panggilan kembali.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header vhf.h
Pustaka VhfKm.lib
IRQL <= DISPATCH_LEVEL

Lihat juga

Menulis driver sumber HID dengan menggunakan Virtual HID Framework (VHF)