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