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.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.hBibliothèque : xgameruntime.lib
Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series
