Skip to main content

​
XGameActivationRegisterForEvent

활성화 이벤트에 대한 콜백을 등록합니다.

​
구문

​
매개 변수

queue   _In_opt_
형식: XTaskQueueHandle 이벤트 콜백을 디스패치하는 작업 큐입니다. context   _In_opt_
형식: void* 이벤트 콜백에 전달되는 컨텍스트입니다. callback   _In_
형식: XGameActivationCallback* 이벤트 콜백 함수입니다. token   _Out_
형식: XTaskQueueRegistrationToken* 등록을 나타내는 작업 큐의 토큰입니다. 이 토큰을 사용하여 활성화 이벤트에 대한 콜백을 등록 해제합니다.

​
반환 값

형식: HRESULT HRESULT 성공 또는 오류 코드입니다.
오류 코드 목록은 오류 코드를 참조하세요.

​
설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
XGameActivationRegisterForEvent 함수는 인수로 XGameActivationCallback을 사용합니다. 콜백은 활성화 유형과 해당 데이터를 포함하는 XGameActivationInfo 구조체를 받습니다. 이 API는 프로토콜 활성화, 파일 활성화 및 게임 초대를 포함한 모든 활성화 유형을 처리합니다. 이는 사용되지 않는 XGameProtocolRegisterForActivation 및 XGameInviteRegisterForEvent API를 대체합니다. 활성화 이벤트에 대한 콜백을 등록 해제하려면 XGameActivationUnregisterForEvent를 호출합니다. 이 함수 호출에 대한 예제는 XGameActivationCallback 항목의 설명 섹션을 참조하세요.

​
요구 사항

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

​
개념 문서

​
함께 보기

XGameActivation XGameActivationCallback XGameActivationUnregisterForEvent
마지막 수정일 2026년 8월 24일

관련 항목

XGameActivationXGameActivationUnregisterForEventXGameActivationCallbackXGameProtocolRegisterForActivation (deprecated)초대 받기