funzione HidD_GetManufacturerString (hidsdi.h)
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 |