| UID | title | description | old-location | tech.root | ms.date | keywords | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | f1_keywords | topic_type | api_type | api_location | api_name | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NI:hidclass.IOCTL_HID_GET_SERIALNUMBER_STRING |
IOCTL_HID_GET_SERIALNUMBER_STRING (hidclass.h) |
The IOCTL_HID_GET_SERIALNUMBER_STRING request obtains a top-level collection's embedded string that identifies the device's serial number. |
hid\ioctl_hid_get_serialnumber_string.htm |
hid |
04/30/2018 |
|
IOCTL_HID_GET_SERIALNUMBER_STRING, IOCTL_HID_GET_SERIALNUMBER_STRING control, IOCTL_HID_GET_SERIALNUMBER_STRING control code [Human Input Devices], hid.ioctl_hid_get_serialnumber_string, hidclass/IOCTL_HID_GET_SERIALNUMBER_STRING, hidioreq_6f0fd737-3834-4f3e-be8d-4027b6525c87.xml |
hidclass.h |
Hidclass.h |
Windows |
Windows |
|
|
|
|
|
The IOCTL_HID_GET_SERIALNUMBER_STRING request obtains a top-level collection's embedded string that identifies the device's serial number. The retrieved string is a NULL-terminated wide character string in a human-readable format.
For general information about HIDClass devices, see HID Collections.
Parameters.DeviceIoControl.OutputBufferLength in the I/O stack location of the IRP indicates the size, in bytes, of the output buffer. If the output buffer is not large enough to hold the entire NULL-terminated embedded string, the request returns nothing in the output buffer.
The maximum possible number of characters in an embedded string is device specific. For USB devices, the maximum string length is 126 wide characters (not including the terminating NULL character).
Irp->MdlAddress points to a buffer to receive the serial number string (a NULL-terminated wide character string).
The length of a NULL-terminated wide character string. The supplied buffer must be <= 4093 bytes (2^12 – 3).
The HID class driver sets the following fields of Irp->IoStatus:
-
Information is set to the number of bytes transferred from the device.
-
Status is set to STATUS_SUCCESS if the transfer completed without error. Otherwise, it is set to an appropriate NTSTATUS error code.