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 chemin PnP 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 chemin PnP, y compris le caractère null de fin.Remarques
La méthode écrit le chemin PnP dans buffer uniquement si buffer n’est pasnullptr 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 chemin, 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 chemin PnP, la taille requise est de 1 et la méthode écrit une chaîne vide.
Utilisez le chemin PnP pour référencer le périphérique sous-jacent via d’autres API. Comme le chemin est encodé en UTF-8, convertissez-le en UTF-16 (par exemple, à l’aide de MultiByteToWideChar avec CP_UTF8) avant de le transmettre à des API Windows qui attendent des chaînes de caractères larges.
Le chemin 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 PnP d’un périphérique.
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 SeriesVoir aussi
Vue d’ensemble de GameInputIGameInputDevice
IGameInputDevice::GetDisplayName
IGameInputDevice::GetContainerId
