Skip to main content

XUserRegisterForChangeEvent

사용자 변경 이벤트에 대한 콜백을 등록합니다.

구문

매개변수

queue   _In_opt_
형식: XTaskQueueHandle
작업을 수행할 비동기 큐에 대한 핸들입니다. context   _In_opt_
형식: void*
콜백에 전달할 사용자 정의 컨텍스트입니다. callback   _In_
형식: XUserChangeEventCallback*
등록할 사용자 정의 콜백입니다. token   _Out_
형식: XTaskQueueRegistrationToken*
등록된 콜백을 식별하는 토큰을 포함합니다. 이 토큰을 사용하여 콜백 등록을 취소합니다.

반환값

형식: HRESULT HRESULT 성공 또는 오류 코드입니다.
오류 코드 목록은 Error Codes를 참조하십시오.

설명

이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 Time-sensitive threads를 참조하십시오.
XUserChangeEvent 열거형은 변경 이벤트 유형을 지정합니다. XUserChangeEventCallback은 사용자 변경 이벤트에 대한 콜백입니다. 이전에 등록한 사용자 변경 콜백을 등록 취소하려면 XUserUnregisterForChangeEvent를 호출합니다. 다음 예제에서는 사용자 변경 이벤트를 처리하는 방법을 보여줍니다.

요구 사항

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

개념 문서

함께 보기

XUser XUserChangeEvent XUserChangeEventCallback XUserUnregisterForChangeEvent
마지막 수정일 2026년 8월 24일