HidD_GetIndexedString (hidsdi.h)
Rutinitas HidD_GetIndexedString mengembalikan string yang disematkan tertentu dari koleksi tingkat atas.
Sintaks
BOOLEAN HidD_GetIndexedString(
[in] HANDLE HidDeviceObject,
[in] ULONG StringIndex,
[out] PVOID Buffer,
[in] ULONG BufferLength
);
Parameter
[in] HidDeviceObject
Menentukan handel terbuka ke koleksi tingkat atas.
[in] StringIndex
Menentukan indeks khusus perangkat dari string yang disematkan.
[out] Buffer
Penunjuk ke buffer yang dialokasikan penelepon yang digunakan rutin untuk mengembalikan string yang disematkan yang ditentukan oleh StringIndex. Rutinitas mengembalikan string karakter lebar yang dihentikan NULL dalam format yang dapat dibaca manusia.
[in] BufferLength
Menentukan panjang, dalam byte, dari buffer yang dialokasikan pemanggil yang disediakan di Buffer. Jika buffer tidak cukup besar untuk mengembalikan seluruh string tersemat yang dihentikan NULL, rutin tidak mengembalikan apa pun di buffer. Buffer yang disediakan harus <= 4093 byte (2^12 – 3).
Nilai kembali
HidD_GetIndexedString mengembalikan TRUE jika berhasil mengembalikan seluruh string tersemat yang dihentikan NULL. Jika tidak, rutinitas mengembalikan FALSE. Gunakan GetLastError untuk mendapatkan informasi kesalahan yang diperluas.
Keterangan
Hanya aplikasi mode pengguna yang dapat memanggil HidD_GetIndexedString. Driver mode kernel dapat menggunakan permintaan IOCTL_HID_GET_INDEXED_STRING .
Jumlah karakter maksimum yang mungkin dalam string yang disematkan adalah spesifik perangkat. Untuk perangkat USB, panjang string maksimum adalah 126 karakter lebar (tidak termasuk karakter NULL yang mengakhiri).
Anggota iProduct dari struktur USB_DEVICE_DESCRIPTOR untuk antarmuka tertentu diatur oleh driver induk generik kelas umum USB berdasarkan aturan berikut:
Jika anggota iInterface dari struktur USB_INTERFACE_DESCRIPTOR untuk antarmuka bukan nol, anggota iProduct dari struktur USB_DEVICE_DESCRIPTOR untuk antarmuka diatur ke anggota iInterface dari struktur USB_INTERFACE_DESCRIPTOR.
Jika antarmuka dikelompokkan menurut deskriptor asosiasi antarmuka USB dan anggota iFunction dari deskriptor asosiasi antarmuka untuk antarmuka bukan nol, anggota iProduct dari struktur USB_DEVICE_DESCRIPTOR untuk antarmuka diatur ke anggota iFunction deskriptor asosiasi antarmuka.
Jika buffer yang disediakan tidak <= 4093 byte (2^12 – 3) panggilan mungkin gagal (tergantung pada protokol yang mendasar, HID/Bluetooth/SPI) dengan kode kesalahan ERROR_GEN_FAILURE (0x0000001f)
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 |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk