IOCTL_HID_GET_PRODUCT_STRING IOCTL (hidclass.h)
Die IOCTL_HID_GET_PRODUCT_STRING Anforderung ruft die eingebettete Zeichenfolge einer Sammlung der obersten Ebene ab, die das Produkt des Herstellers identifiziert. Die abgerufene Zeichenfolge ist eine MIT NULL endende Breitzeichenzeichenfolge in einem lesbaren Format.
Allgemeine Informationen zu HIDClass-Geräten [HID Collections(/windows-hardware/drivers/hid/hid-collections).
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 mit NULL beendete eingebettete Zeichenfolge zu enthalten, gibt die Anforderung nichts im Ausgabepuffer zurück.
Länge des Eingabepuffers
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 Breitzeichen (ohne das abschließende NULL-Zeichen).
Ausgabepuffer
Irp->MdlAddress verweist auf einen Puffer, um die Produkt-ID-Zeichenfolge zu empfangen (eine MIT NULL endende Breitzeichenzeichenfolge).
Länge des Ausgabepuffers
Die Länge einer MIT NULL beendeten Breitzeichenzeichenfolge. Der bereitgestellte Puffer muss = 4093 Bytes (2^12 – 3) sein <.
Statusblock
Der HID-Klassentreiber legt die folgenden Felder von Irp-IoStatus> fest:
Informationen werden 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 geeigneten NTSTATUS-Fehlercode festgelegt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | hidclass.h (include Hidclass.h) |