IOCTL_HID_GET_PRODUCT_STRING IOCTL (hidclass.h)
Die IOCTL_HID_GET_PRODUCT_STRING Anforderung ruft die eingebettete Zeichenfolge einer Auflistung auf oberster Ebene ab, die das Produkt des Herstellers identifiziert. Die abgerufene Zeichenfolge ist eine mit NULL beendete breite Zeichenfolge in einem lesbaren Format.
Allgemeine Informationen zu HIDClass-Geräten [HID Collections(/windows-hardware/drivers/hid/hid/hid-collections).
Hauptcode
Eingabepuffer
Parameters.DeviceIoControl.OutputBufferLength- an der I/O-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 zu enthalten, gibt die Anforderung nichts im Ausgabepuffer zurück.
Eingabepufferlänge
Die maximal mögliche Anzahl von Zeichen in einer eingebetteten Zeichenfolge ist gerätespezifisch. Bei USB-Geräten beträgt die maximale Zeichenfolgenlänge 126 breite Zeichen (nicht einschließlich des endenden NULL-Zeichens).
Ausgabepuffer
Irp->MdlAddress verweist auf einen Puffer, um die Produkt-ID-Zeichenfolge (eine NULL-beendete breite Zeichenzeichenfolge) zu empfangen.
Länge des Ausgabepuffers
Die Länge einer NULL-beendeten breiten Zeichenfolge. Der angegebene Puffer muss <= 4093 Bytes (2^12 – 3) sein.
Statusblock
Der HID-Klassentreiber legt die folgenden Felder von Irp->IoStatus-fest:
Information wird auf die Anzahl der vom Gerät übertragenen Bytes festgelegt.
Status wird auf STATUS_SUCCESS festgelegt, wenn die Übertragung ohne Fehler abgeschlossen wurde. Andernfalls wird er auf einen entsprechenden NTSTATUS-Fehlercode festgelegt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | hidclass.h (include Hidclass.h) |