Skip to main content

XGameStreamingRegisterClientPropertiesChanged

스트리밍 클라이언트 장치의 속성이 변경될 때마다 호출될 콜백을 등록합니다.
등록 시, 콜백은 클라이언트 장치의 현재 클라이언트 속성에 대해 호출됩니다.

구문

매개 변수

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

반환 값

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

잠재적 오류

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

설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
이 API를 사용하면 스트림 물리적 크기와 같은 XGameStreamingClientProperty가 변경될 때마다 게임이 XGameStreamingClientPropertiesChangedCallback을 받을 수 있습니다. 등록 시 콜백은 해당하는 모든 XGameStreamingClientProperty에 대해 호출되므로 현재 속성 세부 정보를 쿼리할 수 있습니다. 스트리밍 클라이언트 장치가 연결 해제될 때는 XGameStreamingUnregisterClientPropertiesChanged를 사용하여 콜백 등록을 해제하세요.

예제

요구 사항

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

개념 문서

함께 보기

XGameStreamingClientProperty
XGameStreamingClientPropertiesChangedCallback
XGameStreamingUnregisterClientPropertiesChanged
XGameStreaming
마지막 수정일 2026년 8월 24일