HidP_SetScaledUsageValue (hidpi.h)
Rutinitas HidP_SetScaledUsageValue mengonversi angka fisik yang ditandatangani dan diskalakan menjadi nilai logis penggunaan HID, dan menetapkan nilai penggunaan dalam laporan HID tertentu.
Sintaks
NTSTATUS HidP_SetScaledUsageValue(
[in] HIDP_REPORT_TYPE ReportType,
[in] USAGE UsagePage,
[in] USHORT LinkCollection,
[in] USAGE Usage,
[in] LONG UsageValue,
[in] PHIDP_PREPARSED_DATA PreparsedData,
[in, out] PCHAR Report,
[in] ULONG ReportLength
);
Parameter
[in] ReportType
Menentukan nilai enumerator HIDP_REPORT_TYPE yang menunjukkan jenis laporan HID yang terletak di Laporan.
[in] UsagePage
Menentukan halaman penggunaan penggunaan.
[in] LinkCollection
Menentukan kumpulan tautan yang berisi penggunaan. Jika LinkCollection bukan nol, rutinitas hanya mengatur penggunaan, jika ada, dalam koleksi tautan ini. Jika LinkCollection nol, rutin mengatur penggunaan pertama yang ditemukannya di koleksi tingkat atas yang terkait dengan PreparsedData.
[in] Usage
Menentukan penggunaan.
[in] UsageValue
Menentukan angka fisik yang ditandatangani dan diskalakan, yang dikonversi rutin menjadi nilai logis penggunaan.
[in] PreparsedData
Penunjuk ke data tingkat atas yang telah disiapkan.
[in, out] Report
Penunjuk ke laporan HID.
[in] ReportLength
Menentukan ukuran, dalam byte, dari laporan HID yang terletak di Laporan, yang harus sama dengan panjang laporan untuk jenis laporan yang ditentukan yang HidP_GetCaps kembalikan dalam struktur HIDP_CAPS koleksi.
Nilai kembali
HidP_SetScaledUsageValue mengembalikan salah satu nilai status berikut:
Menampilkan kode | Deskripsi |
---|---|
|
Rutinitas berhasil menetapkan nilai penggunaan. |
|
Penggunaan memiliki rentang logis atau fisik ilegal yang mencegah penskalakan. |
|
Nilai fisik yang ditentukan di luar rentang dan penggunaan tidak memiliki nilai null. |
|
Panjang laporan tidak valid. |
|
Tipe laporan yang ditentukan tidak valid. |
|
Penggunaan tidak ada dalam laporan yang ditentukan, tetapi memang ada dalam laporan yang berbeda dari jenis yang ditentukan. |
|
Data yang disiapkan tidak valid. |
|
Penggunaan tidak ada dalam laporan apa pun dari jenis laporan yang ditentukan. |
|
Nilai fisik yang ditentukan di luar rentang, penggunaan memiliki nilai null, dan rutin mengatur nilai null. |
Keterangan
HidP_SetScaledUsageValue mengatur bit tanda.
Jika rutinitas mengembalikan HIDP_STATUS_INCOMPATIBLE_REPORT_ID, laporan yang ditentukan memang berisi penggunaan. Namun, aplikasi mode pengguna atau driver mode kernel dapat mengatur penggunaan dalam laporan yang diinisialisasi nol. Lihat Menginisialisasi Laporan HID.
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk