Skip to main content

XGameStreamingGetClientIPAddress

Déconseillé. Cette API est déconseillée depuis la version 2604 du GDK et sera supprimée dans une version ultérieure du GDK. Sur la pile de streaming XBOX Cloud Gaming actuelle, cette API n’est pas fonctionnelle et renvoie E_GAMESTREAMING_NO_DATA en cas de réussite.Si votre titre doit déterminer s’il s’exécute sur un serveur XBOX Game Streaming, ou s’il a besoin de l’emplacement géographique approximatif de l’utilisateur, utilisez plutôt les revendications de jeton XSTS.
Cette API renvoie l’adresse IP de l’appareil client de l’utilisateur final utilisé pour diffuser du contenu en streaming via le service de streaming de jeux Xbox. Cette API et les informations associées ne doivent être utilisées que dans le respect des directives de confidentialité standard de Microsoft concernant l’information des utilisateurs finaux sur la collecte de données. Si vous avez des questions ou des préoccupations concernant l’utilisation conforme de cette API, contactez votre représentant Microsoft.

Syntaxe

Paramètres

client   _In_
Type : XGameStreamingClientId
Client de streaming interrogé. ipAddressSize   _In_
Type : size_t
Taille maximale de la mémoire tampon ipAddress fournie. En règle générale, cette valeur doit simplement être ClientIPAddressMaxBytes. ipAddress   _Out_writes_z_(ipAddressSize)
Type : char*
Mémoire tampon qui sera remplie avec l’adresse IP du client spécifié.

Valeur de retour

Type : HRESULT Renvoie S_OK en cas de réussite ; sinon, renvoie un code d’erreur.

Erreurs potentielles

Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur.

Remarques

ipAddress peut être une adresse IPv4 (1.2.3.4) ou une adresse IPv6 (1:2:3:4:5:6:7:8). ParseNetworkString peut être utilisé pour analyser la chaîne si nécessaire. L’adresse IP renvoyée est celle que la XBOX a reçue du client de streaming. Si le client de streaming utilise un VPN ou se trouve derrière un NAT, l’utilisation de l’adresse IP pour la géolocalisation peut poser problème.
Des adresses IP privées peuvent être renvoyées pendant le développement ou dans des scénarios de lecture à distance où le client de streaming et la XBOX se trouvent sur le même réseau privé.

Exemple

Configuration requise

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

Voir aussi

XGameStreaming
Last modified on October 6, 2026