XGameStreamingGetClients

현재 연결된 각 클라이언트의 ID를 가져옵니다.

구문

HRESULT XGameStreamingGetClients(  
         uint32_t clientCount,  
         XGameStreamingClientId* clients,  
         uint32_t* clientsUsed  
)

clientCount _In_
형식: uint32_t

클라이언트 배열에서 반환할 최대 클라이언트 수

clients _Out_writes_to_(clientCount,clientsUsed)
형식: XGameStreamingClientId

연결된 클라이언트 ID를 저장할 버퍼

clientsUsed _Out_
형식: uint32_t*

클라이언트 배열에 기록된 실제 클라이언트 수

형식: HRESULT

성공한 경우 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

오류 코드	오류 값	오류 발생 원인
E_GAMESTREAMING_NOT_INITIALIZED	0x89245400	XGameStreaming 런타임이 아직 초기화되지 않았습니다. 다른 API를 호출하기 전에 XGameStreamingInitialize를 호출합니다.
E_NOT_SUFFICIENT_BUFFER	0x7A	clientCount에 지정된 수가 현재 연결된 클라이언트 수보다 작습니다.

오류 코드 목록은 오류 코드를 참조하세요.

현재 연결된 모든 스트리밍 클라이언트 디바이스의 XGameStreamingClientId을(를) 가져오는 데 사용됩니다.

게임에서 장치가 연결되어 있고 스트리밍 중인지 식별하려는 경우에만 XGameStreamingIsStreaming을 사용하는 것이 좋습니다.

스트리밍 클라이언트가 연결 및/또는 연결을 끊을 때 게임에서 알림을 받으려면 XGameStreamingRegisterConnectionStateChanged를 사용하는 것이 좋습니다.

헤더: xgamestreaming.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔