funzione HidD_GetSerialNumberString (hidsdi.h)
La routine HidD_GetSerialNumberString restituisce la stringa incorporata di una raccolta di primo livello che identifica il numero di serie del dispositivo fisico della raccolta.
Sintassi
BOOLEAN HidD_GetSerialNumberString(
[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 numero di serie richiesta. La routine restituisce una stringa di caratteri wide con terminazione NULL.
[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 nulla nel buffer. Il buffer fornito deve essere <= 4093 byte (2^12 - 3).
Valore restituito
HidD_GetSerialNumberString restituisce true se restituisce correttamente l'intera stringa incorporata con terminazione NULL. In caso contrario, la routine restituisce FALSE. Usare GetLastError per ottenere informazioni estese sull'errore.
Osservazioni
Solo le applicazioni in modalità utente possono chiamare HidD_GetSerialNumberString. I driver in modalità kernel possono usare IOCTL_HID_GET_SERIALNUMBER_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.
Fabbisogno
| 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 |