Microsoft Game Development Kit API 작업 실행 예제 - XBOX Game Development Documentation

이 항목은 Microsoft Game Development Kit(GDK) API 작업을 실행하는 방법의 예를 제공합니다. 비동기 Microsoft Game Development Kit(GDK) API 함수는 내부적으로 작업 콜백을 구현합니다. 그러나 async 블록에 지정된 작업 큐의 지시에 따라 실행됩니다. 이러한 메서드를 실행하려면 async 블록과 API에 필요한 매개 변수가 있어야 합니다.

// Set up the async block and completion callback.
XAsyncBlock* async = new XAsyncBlock{};
async->queue = taskQueue;
async->context = nullptr;
async->callback = [](XAsyncBlock* async)
{
    XUserHandle newUser = nullptr;
    HRESULT result = XUserAddResult(async, &newUser);
    // Handle the completion callback.
    delete async;
};

// Start the async call.
HRESULT hr = XUserAddAsync(XUserAddOptions::None, async);
if (FAILED(hr))
{
    delete async;
}

이 코드는 일반 작업 실행 코드와 크게 다르지 않습니다. 작업 콜백과 함께 XAsyncRun을 사용하는 대신 사용하려는 API를 호출합니다. async 블록은 동일한 방식으로 설정됩니다. 차이점은 XUserAddAsync의 경우 호출로부터 검색할 데이터가 있어서 XUserAddResult를 사용하여 완료 콜백에서 이를 수행한다는 점입니다.

참고 API 문서

XAsync(API 콘텐츠)
- 함수
  - XAsyncRun
xuser(API 콘텐츠)
- 함수
  - XUserAddAsync
  - XUserAddResult

참고 항목

XAsync 라이브러리 개요 비동기 작업 설정(예제) 간단한 작업 실행(예제) XAsync

마지막 수정일 2026년 8월 13일

관련 항목

간단한 작업 실행 예제 비동기 작업 설정 예제 비동기 작업 프로그래밍을 위한 XAsync 라이브러리 방법: 프로세스 작업 큐 사용 비동기 프로그래밍 개요

⌘I