Bagikan melalui

HidD_GetFeature (hidsdi.h)

  • Artikel

Rutinitas HidD_GetFeature mengembalikan laporan fitur dari koleksi tingkat atas tertentu.

Sintaks

BOOLEAN HidD_GetFeature(
  [in]  HANDLE HidDeviceObject,
  [out] PVOID  ReportBuffer,
  [in]  ULONG  ReportBufferLength
);

Parameter

[in] HidDeviceObject

Handel terbuka ke koleksi tingkat atas.

[out] ReportBuffer

Penunjuk ke buffer laporan HID yang dialokasikan penelepon yang digunakan pemanggil untuk menentukan ID laporan. HidD_GetFeature menggunakan ReportBuffer untuk mengembalikan laporan fitur yang ditentukan.

Untuk informasi selengkapnya tentang parameter ini, lihat bagian Keterangan .

[in] ReportBufferLength

Ukuran buffer laporan dalam byte. Buffer laporan harus cukup besar untuk menyimpan laporan fitur ditambah satu byte tambahan yang menentukan ID laporan bukan nol. Jika ID laporan tidak digunakan, nilai ID adalah nol.

Nilai kembali

Jika HidD_GetFeature berhasil, maka akan mengembalikan TRUE; jika tidak, ia mengembalikan FALSE. Gunakan GetLastError untuk mendapatkan informasi kesalahan yang diperluas.

Keterangan

ReportBufferLength yang benar ditentukan oleh anggota FeatureReportByteLength dari struktur HIDP_CAPS koleksi tingkat atas yang dikembalikan dari panggilan HidP_GetCaps.

Sebelum memanggil rutinitas HidD_GetFeature , pemanggil harus melakukan hal berikut:

  • Jika koleksi tingkat atas menyertakan ID laporan, pemanggil harus mengatur byte pertama parameter ReportBuffer ke ID laporan bukan nol.
  • Jika koleksi tingkat atas tidak menyertakan ID laporan, pemanggil harus mengatur byte pertama dari parameter ReportBuffer ke nol.

Laporan fitur dikembalikan dalam parameter ReportBuffer . Bergantung pada ID laporan, pemanggil mengurai laporan dengan memanggil salah satu fungsi berikut:

Untuk contoh cara mengurai laporan HID, lihat aplikasi sampel HClient . Sampel ini terletak di Galeri Kode MSDN.

Hanya aplikasi mode pengguna yang dapat memanggil HidD_GetFeature. Driver mode kernel dapat menggunakan permintaan IOCTL_HID_GET_FEATURE .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows 2000 dan versi Windows yang lebih baru.
Target Platform Universal
Header hidsdi.h (termasuk Hidsdi.h)
Pustaka Hid.lib
DLL Hid.dll

Lihat juga