HidD_GetManufacturerString-Funktion (hidsdi.h)

Artikel
02/26/2024

Die HidD_GetManufacturerString Routine gibt die eingebettete Zeichenfolge einer Auflistung der obersten Ebene zurück, die den Hersteller identifiziert.

Syntax

BOOLEAN HidD_GetManufacturerString(
  [in]  HANDLE HidDeviceObject,
  [out] PVOID  Buffer,
  [in]  ULONG  BufferLength
);

Parameter

[in] HidDeviceObject

Gibt ein geöffnetes Handle für eine Auflistung der obersten Ebene an.

[out] Buffer

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der von der Routine verwendet wird, um die Herstellerzeichenfolge der Sammlung zurückzugeben. Die Routine gibt eine MIT NULL beendete Breitzeichenzeichenfolge in einem lesbaren Format zurück.

[in] BufferLength

Gibt die Länge eines vom Aufrufer zugeordneten Puffers in Bytes an, der unter Buffer bereitgestellt wird. Wenn der Puffer nicht groß genug ist, um die gesamte mit NULL beendete eingebettete Zeichenfolge zurückzugeben, gibt die Routine nichts im Puffer zurück. Der bereitgestellte Puffer muss = 4093 Bytes (2^12 – 3) sein <.

Rückgabewert

HidD_HidD_GetManufacturerString gibt TRUE zurück, wenn die gesamte mit NULL beendete eingebettete Zeichenfolge zurückgegeben wird. Andernfalls gibt die Routine FALSE zurück. Verwenden Sie GetLastError , um erweiterte Fehlerinformationen abzurufen.

Hinweise

Nur Benutzermodusanwendungen können HidD_GetManufacturerString aufrufen. Kernelmodustreiber können eine IOCTL_HID_GET_MANUFACTURER_STRING-Anforderung verwenden.

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).

Wenn der bereitgestellte Puffer nicht <= 4093 Bytes (2^12 – 3) ist, schlägt der Aufruf möglicherweise fehl (abhängig vom zugrunde liegenden Protokoll HID/Bluetooth/SPI) mit fehlercode ERROR_GEN_FAILURE (0x0000001f).

Weitere Informationen finden Sie unter HID-Auflistungen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen von Windows.
Zielplattform	Universell
Header	hidsdi.h (include Hidsdi.h)
Bibliothek	Hid.lib
DLL	Hid.dll