IOCTL_HID_GET_MANUFACTURER_STRING IOCTL (hidclass.h)

Artikel
02/26/2024

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

IRP_MJ_DEVICE_CONTROL

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.