Skip to main content

XGameStreamingRegisterConnectionStateChanged

스트리밍 클라이언트 장치의 연결 상태가 변경될 때 호출될 콜백을 등록합니다. 등록 시, 이미 연결되어 있는 모든 스트리밍 클라이언트 장치에 대해 콜백이 호출됩니다.

구문

매개 변수

queue   _In_opt_
형식: XTaskQueueHandle
변경 콜백을 배치할 비동기 큐에 대한 핸들입니다. context   _In_opt_
형식: void*
콜백 함수에 전달되는 컨텍스트에 대한 선택적 포인터입니다. callback   _In_
형식: XGameStreamingConnectionStateChangedCallback*
스트리밍 클라이언트 장치의 연결 상태가 변경될 때 호출될 콜백 함수입니다. token   _Out_
형식: XTaskQueueRegistrationToken*
이벤트 등록을 해제하는 데 사용할 수 있는 등록 토큰에 대한 포인터입니다.

반환 값

형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

잠재적 오류

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

설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
이 API는 게임이 스트리밍 클라이언트 장치별로 사용자 지정을 수행하고, 연결된 장치가 있는지 여부에 따라 환경을 최적화할 수 있도록 상태를 유지하는 권장 방법입니다.
등록 시, 현재 연결된 모든 스트리밍 클라이언트 장치에 대해 콜백이 호출됩니다.

예제

요구 사항

헤더: xgamestreaming.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

개념 문서

함께 보기

XGameStreamingConnectionState
XGameStreamingConnectionStateChangedCallback
XGameStreamingUnregisterConnectionStateChanged
XGameStreaming
마지막 수정일 2026년 8월 24일