fonction HidD_GetSerialNumberString (hidsdi.h)
La routine HidD_GetSerialNumberString retourne la chaîne incorporée d’une collection de niveau supérieur qui identifie le numéro de série de l’appareil physique de la collection.
Syntaxe
BOOLEAN HidD_GetSerialNumberString(
[in] HANDLE HidDeviceObject,
[out] PVOID Buffer,
[in] ULONG BufferLength
);
Paramètres
[in] HidDeviceObject
Spécifie un handle ouvert dans une collection de niveau supérieur.
[out] Buffer
Pointeur vers une mémoire tampon allouée par l’appelant que la routine utilise pour retourner la chaîne de numéro de série demandée. La routine retourne une chaîne de caractères large terminée par NULL.
[in] BufferLength
Spécifie la longueur, en octets, d’une mémoire tampon allouée par l’appelant fournie à tampon. Si la mémoire tampon n’est pas suffisamment grande pour renvoyer la chaîne incorporée terminée par NULL entière, la routine ne retourne rien dans la mémoire tampon. La mémoire tampon fournie doit être <= 4093 octets (2^12 à 3).
Valeur de retour
HidD_GetSerialNumberString retourne TRUE si elle retourne correctement la chaîne incorporée terminée par NULL. Sinon, la routine retourne FALSE. Utilisez GetLastError pour obtenir des informations d’erreur étendues.
Remarques
Seules les applications en mode utilisateur peuvent appeler HidD_GetSerialNumberString. Les pilotes en mode noyau peuvent utiliser IOCTL_HID_GET_SERIALNUMBER_STRING.
Le nombre maximal de caractères dans une chaîne incorporée est spécifique à l’appareil. Pour les périphériques USB, la longueur maximale de chaîne est de 126 caractères larges (sans inclure le caractère NULL de fin).
Si la mémoire tampon fournie n’est pas <= 4093 octets (2^12 – 3), l’appel peut échouer (selon le protocole sous-jacent, HID/Bluetooth/SPI) avec le code d’erreur ERROR_GEN_FAILURE (0x0000001f)
Pour plus d’informations, consultez collections HID.
Exigences
Exigence | Valeur |
---|---|
client minimum pris en charge | Disponible dans Windows 2000 et versions ultérieures de Windows. |
plateforme cible | Universel |
d’en-tête | hidsdi.h (include Hidsdi.h) |
bibliothèque | Hid.lib |
DLL | Hid.dll |