HidP_SetScaledUsageValue (hidpi.h)

Artikel
08/07/2023

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
HIDP_STATUS_SUCCESS	Rutinitas berhasil menetapkan nilai penggunaan.
HIDP_STATUS_BAD_LOG_PHY_VALUES	Penggunaan memiliki rentang logis atau fisik ilegal yang mencegah penskalakan.
HIDP_STATUS_VALUE_OUT_OF_RANGE	Nilai fisik yang ditentukan di luar rentang dan penggunaan tidak memiliki nilai null.
HIDP_STATUS_INVALID_REPORT_LENGTH	Panjang laporan tidak valid.
HIDP_STATUS_INVALID_REPORT_TYPE	Tipe laporan yang ditentukan tidak valid.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID	Penggunaan tidak ada dalam laporan yang ditentukan, tetapi memang ada dalam laporan yang berbeda dari jenis yang ditentukan.
HIDP_STATUS_INVALID_PREPARSED_DATA	Data yang disiapkan tidak valid.
HIDP_STATUS_USAGE_NOT_FOUND	Penggunaan tidak ada dalam laporan apa pun dari jenis laporan yang ditentukan.
HIDP_STATUS_NULL	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