Passer au contenu principal
Obtient le nom d’affichage convivial du périphérique d’entrée sous forme de chaîne UTF-8.

Syntaxe

Paramètres

bufferByteCount   _In_
Type : uint32_t
Taille, en octets, de la mémoire tampon pointée par buffer. Transmettez 0 pour demander la taille requise. buffer   _Out_writes_bytes_opt_(bufferByteCount)
Type : char*
Mémoire tampon qui reçoit le nom d’affichage UTF-8 terminé par un caractère null. Transmettez nullptr pour demander la taille requise.

Valeur de retour

Type : uint32_t Taille, en octets, de la mémoire tampon nécessaire pour contenir le nom d’affichage, y compris le caractère null de fin.

Remarques

La méthode écrit le nom d’affichage dans buffer uniquement si buffer n’est pas nullptr et si bufferByteCount est supérieur ou égal à la taille requise. Dans le cas contraire, la mémoire tampon n’est pas modifiée. Pour récupérer le nom d’affichage, appelez la méthode une première fois avec un bufferByteCount de 0 et un buffer de nullptr afin d’obtenir la taille requise, allouez une mémoire tampon de cette taille, puis appelez de nouveau la méthode. Si le périphérique n’a pas de nom d’affichage, la taille requise est de 1 et la méthode écrit une chaîne vide. Le nom d’affichage est un nom « convivial » pour le périphérique. Vous pouvez l’afficher dans l’interface utilisateur de votre application, mais rien ne garantit qu’il soit localisé. GameInput recherche cette chaîne à plusieurs emplacements, et l’une des dernières solutions de repli est le microprogramme du périphérique. Le nom d’affichage ne change pas pendant toute la durée de vie de l’objet périphérique. L’exemple suivant récupère le nom d’affichage d’un périphérique.
Dans GameInput v3 et les versions antérieures, ces informations étaient disponibles via le membre displayName de la structure GameInputDeviceInfo retournée par IGameInputDevice::GetDeviceInfo.

Configuration requise

En-tête : GameInput.h Bibliothèque : gameinput.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

Vue d’ensemble de GameInput
IGameInputDevice
IGameInputDevice::GetPnpPath

Historique des versions

Dernière modification le 6 novembre 2026