fungsi HidP_GetUsagesEx (hidpi.h)

Artikel
02/29/2024

Rutinitas HidP_GetUsagesEx mengembalikan daftar semua penggunaan tombol kontrol HID yang diatur ke AKTIF dalam laporan HID.

Sintaks

NTSTATUS HidP_GetUsagesEx(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USHORT               LinkCollection,
  [in, out] PUSAGE_AND_PAGE      ButtonList,
  [in, out] ULONG                *UsageLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData,
  [in]      PCHAR                Report,
  [in]      ULONG                ReportLength
);

Parameter

[in] ReportType

Menentukan nilai enumerator HIDP_REPORT_TYPE yang mengidentifikasi jenis laporan.

[in] LinkCollection

Menentukan kumpulan tautan penggunaan tombol. Jika LinkCollection bukan nol, rutinitas hanya mengembalikan informasi tentang tombol yang dimuat koleksi tautan ini; jika tidak, jika LinkCollection adalah nol, rutin mengembalikan informasi tentang semua tombol dalam koleksi tingkat atas yang terkait dengan PreparsedData.

[in, out] ButtonList

Penunjuk ke buffer yang dialokasikan pemanggil yang digunakan rutin untuk mengembalikan pengidentifikasi halaman penggunaan dan penggunaan untuk setiap tombol yang diatur ke AKTIF (1).

[in, out] UsageLength

Menentukan, pada input, panjang, dalam elemen array, dari buffer ButtonList . Menentukan, pada output, jumlah penggunaan yang saat ini diatur ke AKTIF dalam laporan yang ditentukan.

[in] PreparsedData

Penunjuk ke data koleksi tingkat atas yang telah disiapkan.

[in] Report

Penunjuk ke laporan yang berisi data tombol.

[in] ReportLength

Menentukan panjang, dalam byte, dari laporan yang terletak di Laporan.

Nilai kembali

HidP_GetUsagesEx mengembalikan salah satu nilai status berikut:

Menampilkan kode	Deskripsi
HIDP_STATUS_SUCCESS	Rutinitas berhasil mengembalikan semua penggunaan tombol yang diatur ke AKTIF.
HIDP_INVALID_REPORT_LENGTH	Panjang laporan tidak valid.
HIDP_INVALID_REPORT_TYPE	Tipe laporan yang ditentukan tidak valid.
HIDP_STATUS_BUFFER_TOO_SMALL	Buffer UsageList terlalu kecil untuk menahan semua penggunaan yang saat ini diatur ke AKTIF dalam laporan yang ditentukan.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID	Koleksi berisi tombol dalam laporan jenis yang ditentukan, tetapi tidak ada penggunaan tersebut dalam laporan yang ditentukan.
HIDP_STATUS_INVALID_PREPARSED_DATA	Data yang disiapkan tidak valid.

Keterangan

Aplikasi mode pengguna dan driver mode kernel memanggil HidP_MaxUsageListLength untuk menentukan jumlah maksimum tombol yang dikembalikan untuk jenis laporan tertentu. Atau, aplikasi atau driver dapat memanggil HidP_GetUsagesEx dan mengatur (*UsageLength) ke nol untuk mengembalikan panjang yang diperlukan dalam UsageLength. Dengan kata lain, UsageLength harus menjadi penunjuk yang valid yang menunjuk ke nilai ULONG 0 untuk mendapatkan panjang yang diperlukan.

Aplikasi atau driver menentukan panjang laporan yang diperlukan dari anggota XxxReportByteLength dalam struktur HIDP_CAPS koleksi tingkat atas.

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