HidP_GetScaledUsageValue (hidpi.h)

Artikel
08/07/2023

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
HIDP_STATUS_SUCCESS	Rutinitas berhasil mengembalikan nilai.
HIDP_STATUS_INVALID_REPORT_TYPE	Tipe laporan yang ditentukan tidak valid.
HIDP_STATUS_INVALID_REPORT_LENGTH	Panjang laporan yang ditentukan tidak valid
HIDP_STATUS_BAD_LOG_PHY_VALUES	Koleksi mengembalikan nilai logis atau fisik ilegal. Untuk mengekstrak nilai yang dikembalikan oleh koleksi, panggil HidP_GetUsageValue.
HIDP_STATUS_NULL	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 .
HIDP_STATUS_VALUE_OUT_OF_RANGE	Status data nilai yang diskalakan saat ini dari koleksi kurang dari minimum logis atau lebih besar dari maksimum logis.
HIDP_STATUS_USAGE_NOT_FOUND	Penggunaan, halaman penggunaan, atau kumpulan tautan yang ditentukan tidak dapat ditemukan dalam laporan apa pun yang didukung oleh koleksi tingkat atas yang ditentukan.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID	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

Lihat juga

HidP_GetUsageValue

HidP_GetUsageValueArray

_HIDP_PREPARSED_DATA

Bagikan melalui