Skip to main content

XGameStreamingGetClientIPAddress

Déprécié. Cette API est dépréciée depuis la version 2604 du GDK et sera supprimée dans une version future du GDK. Sur la pile de diffusion en continu actuelle de XBOX Cloud Gaming, cette API n’est pas fonctionnelle et retourne 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 retourne une adresse IP pour l’appareil client de l’utilisateur final utilisé pour diffuser du contenu en continu au moyen du service de diffusion de jeux en continu 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 renseignements. Si vous avez des questions ou des préoccupations concernant l’utilisation conforme de cette API, communiquez avec votre représentant Microsoft.

Syntaxe

Paramètres

client   _In_
Type : XGameStreamingClientId
Client de diffusion en continu interrogé. ipAddressSize   _In_
Type : size_t
Taille maximale de la mémoire tampon ipAddress fournie. En général, 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 Retourne S_OK en cas de réussite; sinon, retourne un code d’erreur.

Erreurs potentielles

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

Remarques

L’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 au besoin. L’adresse IP retournée est celle que la XBOX a reçue du client de diffusion en continu. Si le client de diffusion en continu utilise un RPV 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 retournées pendant le développement ou dans des scénarios de jeu à distance où le client de diffusion en continu 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