HidP_GetSpecificValueCaps (hidpi.h)

Artikel
02/29/2024

Rutinitas HidP_GetSpecificValueCaps mengembalikan array kemampuan nilai yang menjelaskan semua nilai kontrol HID yang memenuhi kriteria pilihan tertentu.

Sintaks

NTSTATUS HidP_GetSpecificValueCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USAGE                UsagePage,
  [in]      USHORT               LinkCollection,
  [in]      USAGE                Usage,
  [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.

[in] UsagePage

Menentukan halaman penggunaan sebagai kriteria pencarian. Jika UsagePage bukan nol, hanya nilai yang menentukan halaman penggunaan ini yang dikembalikan.

[in] LinkCollection

Menentukan kumpulan tautan sebagai kriteria pencarian. Jika LinkCollection bukan nol, hanya nilai yang merupakan bagian dari koleksi tautan ini yang dikembalikan.

[in] Usage

Menentukan penggunaan HID sebagai kriteria pencarian. Jika Penggunaan bukan nol, hanya nilai yang menentukan penggunaan ini yang akan dikembalikan.

[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 input, dalam elemen array, dari buffer yang disediakan di ValueCaps. Pada output, parameter ini diatur ke jumlah elemen yang benar-benar dikembalikan rutin.

[in] PreparsedData

Penunjuk ke data koleksi tingkat atas yang telah disiapkan.

Nilai kembali

HidP_GetSpecificValueCaps mengembalikan salah satu nilai status berikut:

Menampilkan kode	Nilai Status NT	Deskripsi
HIDP_STATUS_SUCCESS	0x00110000	Rutinitas berhasil mengembalikan data kemampuan.
HIDP_STATUS_INVALID_PREPARSED_DATA	0xc0110001	Data yang disiapkan tidak valid.
HIDP_STATUS_USAGE_NOT_FOUND	0xc0110004	Penggunaan tidak ada dalam laporan apa pun dari jenis laporan yang ditentukan.

Keterangan

Ukuran buffer ValueCaps yang diperlukan ditentukan oleh anggota NumberXxxValueCaps dari struktur HIDP_CAPS koleksi tingkat atas.

Saat memanggil HidP_GetSpecificValueCaps, menentukan nol untuk UsagePage, Usage, dan LinkCollection setara dengan memanggil HidP_GetValueCaps.

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	PASSIVE_LEVEL

Lihat juga