HidP_InitializeReportForID (hidpi.h)

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 telah 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.

Mengembalikan nilai

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 diubah.)

HidP_InitializeReportForID melakukan hal berikut:

  • Mengatur ke nol ladang bit 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

   
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

HIDP_CAPS

HIDP_REPORT_TYPE

HidP_GetCaps

_HIDP_PREPARSED_DATA