funzione HidD_GetManufacturerString (hidsdi.h)

Articolo
02/26/2024

La routine HidD_GetManufacturerString restituisce la stringa incorporata di una raccolta di primo livello che identifica il produttore.

Sintassi

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

Parametri

[in] HidDeviceObject

Specifica un handle aperto per una raccolta di primo livello.

[out] Buffer

Puntatore a un buffer allocato dal chiamante utilizzato dalla routine per restituire la stringa del produttore della raccolta. La routine restituisce una stringa di caratteri wide con terminazione NULL in un formato leggibile.

[in] BufferLength

Specifica la lunghezza, in byte, di un buffer allocato dal chiamante fornito in Buffer. Se il buffer non è sufficientemente grande da restituire l'intera stringa incorporata con terminazione NULL, la routine non restituisce alcun valore nel buffer. Il buffer fornito deve essere <= 4093 byte (2^12 - 3).

Valore restituito

HidD_HidD_GetManufacturerString restituisce TRUE se restituisce l'intera stringa incorporata con terminazione NULL. In caso contrario, la routine restituisce FALSE. Usare GetLastError per ottenere informazioni estese sull'errore.

Commenti

Solo le applicazioni in modalità utente possono chiamare HidD_GetManufacturerString. I driver in modalità kernel possono usare una richiesta di IOCTL_HID_GET_MANUFACTURER_STRING .

Il numero massimo possibile di caratteri in una stringa incorporata è specifico del dispositivo. Per i dispositivi USB, la lunghezza massima della stringa è di 126 caratteri wide (non incluso il carattere NULL di terminazione).

Se il buffer fornito non <è = 4093 byte (2^12 - 3), la chiamata potrebbe non riuscire (a seconda del protocollo sottostante, HID/Bluetooth/SPI) con codice di errore ERROR_GEN_FAILURE (0x0000001f).

Per altre informazioni, vedere Raccolte HID.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione	Universale
Intestazione	hidsdi.h (include Hidsdi.h)
Libreria	Hid.lib
DLL	Hid.dll