HidP_SetUsageValue (hidpi.h)
Rutinitas HidP_SetUsageValue menetapkan nilai kontrol HID dalam laporan HID tertentu.
Sintaks
NTSTATUS HidP_SetUsageValue(
[in] HIDP_REPORT_TYPE ReportType,
[in] USAGE UsagePage,
[in] USHORT LinkCollection,
[in] USAGE Usage,
[in] ULONG 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 adalah nol, rutin mengatur penggunaan pertama yang ditemukannya di koleksi tingkat atas yang terkait dengan PreparsedData.
[in] Usage
Menentukan penggunaan.
[in] UsageValue
Menentukan nilai penggunaan.
[in] PreparsedData
Penunjuk ke data tingkat atas yang 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 tertentu yang HidP_GetCaps kembalikan dalam struktur HIDP_CAPS koleksi.
Nilai kembali
HidP_SetUsageValue mengembalikan salah satu nilai status berikut:
Menampilkan kode | Deskripsi |
---|---|
|
Rutinitas berhasil menetapkan nilai penggunaan. |
|
Penggunaan tidak ada dalam laporan yang ditentukan, tetapi ada dalam laporan yang berbeda dari jenis yang ditentukan. |
|
Data yang disiapkan tidak valid. |
|
Tidak ada laporan dari jenis yang ditentukan. |
|
Penggunaan tidak ada dalam laporan apa pun dari jenis laporan yang ditentukan. |
|
Panjang laporan tidak valid. |
|
Tipe laporan yang ditentukan tidak valid. |
Keterangan
HidP_SetUsageValue rutin tidak menandatangani nilai. Aplikasi mode pengguna atau driver mode kernel harus menandatangani nilai, pada posisi yang disediakan dalam struktur HIDP_VALUE_CAPS untuk nilai ini, atau memanggil HidP_SetScaledUsageValue.
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 |