HidP_GetScaledUsageValue (hidpi.h)
Rutinitas HidP_GetScaledUsageValue mengembalikan hasil yang ditandatangani dan diskalakan dari nilai kontrol HID yang diekstrak dari laporan HID.
Sintaks
NTSTATUS HidP_GetScaledUsageValue(
[in] HIDP_REPORT_TYPE ReportType,
[in] USAGE UsagePage,
[in] USHORT LinkCollection,
[in] USAGE Usage,
[out] PLONG UsageValue,
[in] PHIDP_PREPARSED_DATA PreparsedData,
[in] PCHAR Report,
[in] ULONG ReportLength
);
Parameter
[in] ReportType
Menentukan nilai enumerator HIDP_REPORT_TYPE yang mengidentifikasi jenis laporan HID yang berisi nilai penggunaan HID .
[in] UsagePage
Menentukan halaman penggunaan nilai yang akan diekstrak.
[in] LinkCollection
Menentukan pengidentifikasi kumpulan tautan dari nilai yang akan diekstrak. Nilai LinkCollection nol mengidentifikasi koleksi tingkat atas.
[in] Usage
Menentukan penggunaan nilai yang akan diekstrak.
[out] UsageValue
Arahkan ke buffer tempat rutin mengembalikan nilai yang ditandatangani dan diskalakan.
[in] PreparsedData
Arahkan ke data yang telah disiapkan dari koleksi tingkat atas yang menghasilkan laporan yang terletak di Laporan.
[in] Report
Arahkan ke laporan yang berisi penggunaan.
[in] ReportLength
Menentukan panjang, dalam byte, dari laporan yang terletak di Laporan.
Nilai kembali
HidP_GetScaledUsageValue mengembalikan salah satu nilai status berikut:
Menampilkan kode | Deskripsi |
---|---|
|
Rutinitas berhasil mengembalikan nilai. |
|
Tipe laporan yang ditentukan tidak valid. |
|
Panjang laporan yang ditentukan tidak valid |
|
Koleksi mengembalikan nilai logis atau fisik ilegal. Untuk mengekstrak nilai yang dikembalikan oleh koleksi, panggil HidP_GetUsageValue. |
|
Status nilai yang diskalakan saat ini dari koleksi kurang dari minimum logis atau lebih besar dari maksimum logis, dan nilai yang diskalakan memiliki status NULL . |
|
Status data nilai yang diskalakan saat ini dari koleksi kurang dari minimum logis atau lebih besar dari maksimum logis. |
|
Penggunaan, halaman penggunaan, atau kumpulan tautan yang ditentukan tidak dapat ditemukan dalam laporan apa pun yang didukung oleh koleksi tingkat atas yang ditentukan. |
|
Nilai yang ditentukan tidak terkandung dalam laporan yang ditentukan, tetapi terkandung dalam laporan lain yang didukung oleh koleksi tingkat atas yang ditentukan. |
Keterangan
Buffer yang dialokasikan penelepon yang disediakan di PreparsedData, UsageValue, dan Report harus dialokasikan dari kumpulan yang tidak di-patahkan.
Aplikasi mode pengguna dan driver mode kernel harus menggunakan HidP_GetUsageValueArray untuk mengekstrak data untuk array nilai penggunaan.
Jika rutin mengembalikan status HIDP_STATUS_BAD_LOG_PHY_VALUES, aplikasi atau driver dapat memanggil HidP_GetUsageValue untuk mengekstrak data penggunaan mentah.
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 |