HidD_GetManufacturerString fonction (hidsdi.h)
La routine HidD_GetManufacturerString retourne la chaîne incorporée d’une collection de niveau supérieur qui identifie le fabricant.
Syntaxe
BOOLEAN HidD_GetManufacturerString(
[in] HANDLE HidDeviceObject,
[out] PVOID Buffer,
[in] ULONG BufferLength
);
Paramètres
[in] HidDeviceObject
Spécifie un handle ouvert à une collection de niveau supérieur.
[out] Buffer
Pointeur vers une mémoire tampon allouée à l’appelant que la routine utilise pour retourner la chaîne de fabricant de la collection. La routine retourne une chaîne de caractères larges terminée par null dans un format lisible par l’homme.
[in] BufferLength
Spécifie la longueur, en octets, d’une mémoire tampon allouée à l’appelant fournie dans La mémoire tampon. Si la mémoire tampon n’est pas assez grande pour renvoyer l’intégralité de la chaîne incorporée terminée par NULL, la routine ne retourne rien dans la mémoire tampon. La mémoire tampon fournie doit être <= 4 093 octets (2^12 – 3).
Valeur retournée
HidD_HidD_GetManufacturerString retourne TRUE s’il retourne l’intégralité de 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_GetManufacturerString. Les pilotes en mode noyau peuvent utiliser une requête IOCTL_HID_GET_MANUFACTURER_STRING .
Le nombre maximal possible 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 le caractère NULL de fin).
Si la mémoire tampon fournie n’est pas <= 4 093 octets (2^12 à 3), l’appel peut échouer (en fonction du protocole sous-jacent, HID/Bluetooth/SPI) avec le code d’erreur ERROR_GEN_FAILURE (0x0000001f).
Pour plus d’informations, consultez Collections HID.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 2000 et versions ultérieures de Windows. |
| Plateforme cible | Universal |
| En-tête | hidsdi.h (inclure Hidsdi.h) |
| Bibliothèque | Hid.lib |
| DLL | Hid.dll |