IOCTL_HID_GET_MANUFACTURER_STRING IOCTL (hidclass.h)
Die IOCTL_HID_GET_MANUFACTURER_STRING-Anforderung ruft die eingebettete Zeichenfolge einer Sammlung auf oberster Ebene ab, die den Hersteller des Geräts identifiziert. Die abgerufene Zeichenfolge ist eine MIT NULL endende Breitzeichenzeichenfolge 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 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 Hersteller-ID (eine MIT NULL endende Breitzeichenzeichenfolge) zu empfangen.
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) |