IOCTL_HID_GET_SERIALNUMBER_STRING IOCTL (hidclass.h)
Permintaan IOCTL_HID_GET_SERIALNUMBER_STRING mendapatkan string tersemat koleksi tingkat atas yang mengidentifikasi nomor seri perangkat. String yang diambil adalah string karakter lebar yang dihentikan NULL dalam format yang dapat dibaca manusia.
Untuk informasi umum tentang perangkat HIDClass, lihat Koleksi HID.
Kode utama
Buffer input
Parameters.DeviceIoControl.OutputBufferLength di lokasi tumpukan I/O IRP menunjukkan ukuran, dalam byte, dari buffer output. Jika buffer output tidak cukup besar untuk menahan seluruh string tersemat yang dihentikan NULL, permintaan tidak mengembalikan apa pun di buffer output.
Panjang buffer input
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).
Buffer output
Irp->MdlAddress menunjuk ke buffer untuk menerima string nomor seri (string karakter lebar yang dihentikan NULL).
Panjang buffer output
Panjang string karakter lebar yang dihentikan NULL. Buffer yang disediakan harus <= 4093 byte (2^12 – 3).
Blok status
Driver kelas HID mengatur bidang Irp-IoStatus> berikut:
Informasi diatur ke jumlah byte yang ditransfer dari perangkat.
Status diatur ke STATUS_SUCCESS jika transfer selesai tanpa kesalahan. Jika tidak, kode ini diatur ke kode kesalahan NTSTATUS yang sesuai.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | hidclass.h (termasuk Hidclass.h) |