HidD_GetPhysicalDescriptor (hidsdi.h)

Artikel
02/29/2024

Rutinitas HidD_GetPhysicalDescriptor mengembalikan Deskriptor Fisik dari koleksi tingkat atas yang mengidentifikasi perangkat fisik koleksi.

Deskriptor Fisik digunakan untuk menunjukkan bagian fisik tubuh manusia apa yang digunakan untuk mengaktifkan kontrol pada perangkat. Misalnya, Deskriptor Fisik mungkin menunjukkan bahwa jempol kanan digunakan untuk mengaktifkan tombol 5.

Perhatikan bahwa Deskriptor Fisik sepenuhnya opsional. Mereka menambah kompleksitas dan menawarkan sangat sedikit sebagai balasan untuk sebagian besar perangkat. Namun, beberapa perangkat, terutama yang memiliki sejumlah besar kontrol identik (misalnya, tombol) akan menemukan bahwa Deskriptor Fisik membantu aplikasi yang berbeda menetapkan fungsionalitas ke kontrol ini dengan cara yang lebih konsisten. Lihat Spesifikasi HID untuk informasi selengkapnya.

Sintaks

BOOLEAN HidD_GetPhysicalDescriptor(
  [in]  HANDLE HidDeviceObject,
  [out] PVOID  Buffer,
  [in]  ULONG  BufferLength
);

Parameter

[in] HidDeviceObject

Menentukan handel terbuka ke koleksi tingkat atas.

[out] Buffer

Arahkan ke buffer yang dialokasikan penelepon yang digunakan rutin untuk mengembalikan deskriptor fisik yang diminta.

[in] BufferLength

Menentukan panjang, dalam byte, dari buffer di Buffer.

Nilai kembali

HidD_GetPhysicalDescriptor mengembalikan TRUE jika berhasil; jika tidak, ia mengembalikan FALSE. Gunakan GetLastError untuk mendapatkan informasi kesalahan yang diperluas.

Keterangan

Hanya aplikasi mode pengguna yang dapat memanggil HidD_GetPhysicalDescriptor. Driver mode kernel dapat menggunakan permintaan IOCTL_GET_PHYSICAL_DESCRIPTOR .

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	hidsdi.h (termasuk Hidsdi.h)
Pustaka	Hid.lib
DLL	Hid.dll