fungsi HidP_InitializeReportForID (hidpi.h)

Artikel
02/26/2024

Rutinitas HidP_InitializeReportForID menginisialisasi laporan HID.

Sintaks

NTSTATUS HidP_InitializeReportForID(
  [in]  HIDP_REPORT_TYPE     ReportType,
  [in]  UCHAR                ReportID,
  [in]  PHIDP_PREPARSED_DATA PreparsedData,
  [out] PCHAR                Report,
  [in]  ULONG                ReportLength
);

Parameter

[in] ReportType

Menentukan enumerator HIDP_REPORT_TYPE yang menunjukkan jenis laporan HID yang terletak di Laporan.

[in] ReportID

Menentukan ID laporan.

[in] PreparsedData

Arahkan ke data yang disiapkan dari koleksi tingkat atas yang terkait dengan laporan HID yang terletak di Laporan.

[out] Report

Arahkan ke buffer yang dialokasikan pemanggil yang berisi laporan HID yang HidP_InitializeReportForID inisialisasi.

[in] ReportLength

Menentukan ukuran, dalam byte, dari laporan HID yang terletak di Laporan. ReportLength harus sama dengan panjang laporan koleksi untuk jenis laporan yang ditentukan, seperti yang ditentukan oleh anggota XxxReportByteLength dari struktur HIDP_CAPS koleksi.

Nilai kembali

HidP_InitializeReportForID mengembalikan salah satu nilai status berikut:

Menampilkan kode	Deskripsi
HIDP_STATUS_SUCCESS	Laporan berhasil diinisialisasi.
HIDP_STATUS_INVALID_PREPARSED_DATA	Data yang disiapkan tidak valid.
HIDP_STATUS_INVALID_REPORT_LENGTH	Panjang laporan yang ditentukan tidak sama dengan panjang laporan koleksi untuk jenis laporan yang ditentukan.
HIDP_STATUS_INVALID_REPORT_TYPE	Tipe laporan tidak valid.
HIDP_STATUS_REPORT_DOES_NOT_EXIST	ID laporan yang ditentukan tidak valid.

Keterangan

Menginisialisasi laporan HID mengatur semua data kontrol ke nol atau nilai null kontrol, seperti yang ditentukan oleh standar USB HID. (Mengirim atau menerima nilai null menunjukkan bahwa nilai kontrol saat ini tidak boleh dimodifikasi.)

HidP_InitializeReportForID melakukan hal berikut:

Mengatur ke nol bitfield dari semua tombol dan nilai tanpa nilai null.
Mengatur bitfield dari semua kontrol dengan nilai null ke nilai null yang sesuai.

Untuk informasi selengkapnya, lihat Koleksi HID.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 2000 dan versi Windows yang lebih baru.
Target Platform	Universal
Header	hidpi.h (termasuk Hidpi.h)
Pustaka	Hidparse.lib
IRQL	<= DISPATCH_LEVEL

Lihat juga