Passer au contenu principal
Obtient le chemin d’accès Plug and Play (PnP) du périphérique d’entrée sous forme de chaîne UTF-8.

Syntaxe

Paramètres

bufferByteCount   _In_
Type : uint32_t
La taille, en octets, de la mémoire tampon pointée par buffer. Transmettez 0 pour interroger la taille requise. buffer   _Out_writes_bytes_opt_(bufferByteCount)
Type : char*
La mémoire tampon qui reçoit le chemin d’accès PnP UTF-8 terminé par un caractère nul. Transmettez nullptr pour interroger la taille requise.

Valeur de retour

Type : uint32_t La taille, en octets, de la mémoire tampon requise pour contenir le chemin d’accès PnP, y compris le caractère nul de fin.

Remarques

La méthode écrit le chemin d’accès PnP dans buffer uniquement si buffer n’est pas nullptr et si bufferByteCount est supérieur ou égal à la taille requise. Sinon, la mémoire tampon n’est pas modifiée. Pour récupérer le chemin d’accès, appelez la méthode une première fois avec un bufferByteCount de 0 et un buffer de nullptr pour 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 chemin d’accès PnP, la taille requise est 1 et la méthode écrit une chaîne vide. Utilisez le chemin d’accès PnP pour référencer le périphérique sous-jacent au moyen d’autres API. Comme le chemin d’accès est encodé en UTF-8, convertissez-le en UTF-16 (par exemple, à l’aide de MultiByteToWideChar avec CP_UTF8) avant de le transmettre aux API Windows qui attendent des chaînes de caractères larges. Le chemin d’accès PnP ne change pas pendant toute la durée de vie de l’objet périphérique. L’exemple suivant récupère le chemin d’accès PnP d’un périphérique.
Dans GameInput v3 et les versions antérieures, ces informations étaient disponibles dans le membre pnpPath 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::GetDisplayName
IGameInputDevice::GetContainerId

Historique des versions

Dernière modification le 6 novembre 2026