IOCTL_HID_GET_SERIALNUMBER_STRING IOCTL (hidclass.h)
Die IOCTL_HID_GET_SERIALNUMBER_STRING Anforderung ruft die eingebettete Zeichenfolge einer Auflistung der obersten Ebene ab, die die Seriennummer des Geräts identifiziert. Die abgerufene Zeichenfolge ist eine MIT NULL beendete breite Zeichenfolge in einem lesbaren Format.
Allgemeine Informationen zu HIDClass-Geräten finden Sie unter HID-Sammlungen.
Hauptcode
Eingabepuffer
Parameters.DeviceIoControl.OutputBufferLength in der E/A-Stapelposition des IRP gibt die Größe des Ausgabepuffers in Bytes an. Wenn der Ausgabepuffer nicht groß genug ist, um die gesamte eingebettete NULL-Zeichenfolge aufzunehmen, gibt die Anforderung nichts im Ausgabepuffer zurück.
Eingabepufferlänge
Die maximal mögliche Anzahl von Zeichen in einer eingebetteten Zeichenfolge ist gerätespezifisch. Für USB-Geräte beträgt die maximale Zeichenfolgenlänge 126 breite Zeichen (ohne das beendende NULL-Zeichen).
Ausgabepuffer
Irp->MdlAddress verweist auf einen Puffer, um die Seriennummernzeichenfolge (eine mit NULL beendete breite Zeichenfolge) zu empfangen.
Länge des Ausgabepuffers
Die Länge einer mit NULL beendeten breiten Zeichenfolge. Der bereitgestellte Puffer muss = 4093 Bytes (2^12 – 3) sein <.
Statusblock
Der HID-Klassentreiber legt die folgenden Felder von Irp-IoStatus> fest:
Informationen sind auf die Anzahl der vom Gerät übertragenen Bytes festgelegt.
Der Status wird auf STATUS_SUCCESS festgelegt, wenn die Übertragung ohne Fehler abgeschlossen wurde. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode festgelegt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | hidclass.h (include Hidclass.h) |