fungsi HidP_GetValueCaps (hidpi.h)

Artikel
03/01/2024

Rutinitas HidP_GetValueCaps mengembalikan array kemampuan nilai yang menjelaskan semua nilai kontrol HID dalam koleksi tingkat atas untuk jenis laporan HID tertentu.

Sintaks

NTSTATUS HidP_GetValueCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [out]     PHIDP_VALUE_CAPS     ValueCaps,
  [in, out] PUSHORT              ValueCapsLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData
);

Parameter

[in] ReportType

Menentukan nilai enumerator HIDP_REPORT_TYPE yang mengidentifikasi jenis laporan.

[out] ValueCaps

Penunjuk ke buffer yang dialokasikan pemanggil di mana rutinitas mengembalikan array kemampuan nilai untuk jenis laporan yang ditentukan.

[in, out] ValueCapsLength

Menentukan panjang, pada input, dalam elemen array, dari buffer ValueCaps . Pada output, rutin mengatur ValueCapsLength ke jumlah elemen yang benar-benar dikembalikan.

[in] PreparsedData

Penunjuk ke data koleksi tingkat atas yang disiapkan.

Nilai kembali

HidP_GetValueCaps mengembalikan salah satu nilai status berikut:

Menampilkan kode	Deskripsi
HIDP_STATUS_SUCCESS	Rutinitas berhasil mengembalikan data kemampuan.
HIDP_STATUS_INVALID_PREPARSED_DATA	Data yang disiapkan tidak valid.

Keterangan

Panjang yang benar untuk ValueCapsLength ditentukan oleh anggota NumberXxxValueCaps dari struktur HIDP_CAPS koleksi tingkat atas.

Untuk informasi selengkapnya tentang kemampuan koleksi, lihat Mendapatkan Informasi Koleksi.

Lihat juga 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