> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XAsyncRun

> XAsyncRun

# XAsyncRun

지정된 콜백 함수를 비동기적으로 실행합니다.

## 구문

```cpp theme={null}
HRESULT XAsyncRun(  
         XAsyncBlock* asyncBlock,  
         XAsyncWork* work  
)  
```

### 매개 변수

*asyncBlock*   \_Inout\_\
형식: [XAsyncBlock\*](https://docs.xbox.com/ko/reference/system/xasync/structs/xasyncblock.md)

비동기 호출을 추적하는 데 사용되는 [XAsyncBlock](https://docs.xbox.com/ko/reference/system/xasync/structs/xasyncblock.md)에 대한 포인터입니다.

*work*   \_In\_\
형식: [XAsyncWork\*](https://docs.xbox.com/ko/reference/system/xasync/functions/xasyncwork.md)

비동기적으로 실행할 콜백 함수에 대한 포인터입니다.

### 반환 값

형식: [HRESULT](https://learn.microsoft.com/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

성공하면 `S_OK`를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 [오류 코드](https://docs.xbox.com/ko/reference/errorcodes.md)를 참조하세요.

## 설명

`XAsyncRun`은 *work*에 지정된 콜백 함수를 비동기적으로 실행하는 도우미 함수입니다. *asyncBlock*에 지정된 `XAsyncBlock`을 사용하여 콜백 함수를 취소하거나 상태를 가져올 수 있습니다. `XAsyncRun`은 내부적으로 다음 `XAsyncProvider` 함수를 사용하여 콜백 함수를 실행하고 추적합니다:

* [XAsyncBegin](https://docs.xbox.com/ko/reference/system/xasyncprovider/functions/xasyncbegin.md)
* [XAsyncComplete](https://docs.xbox.com/ko/reference/system/xasyncprovider/functions/xasynccomplete.md)
* [XAsyncSchedule](https://docs.xbox.com/ko/reference/system/xasyncprovider/functions/xasyncschedule.md)

`XAsyncProvider` 및 `XAsyncBlock`을 사용하여 자체 비동기 기능을 구현하는 것에 대한 자세한 내용은 [비동기 프로그래밍 모델](https://docs.xbox.com/ko/build/core-features/common/async/async-programming-model.md)을 참조하세요.

## 요구 사항

**헤더:** XAsync.h

**라이브러리:** xgameruntime.lib

**지원되는 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 개념 설명서

* [Microsoft Game Development Kit(GDK) API 작업 실행](https://docs.xbox.com/ko/build/core-features/common/async/async-libraries/async-library-xasync-example-run-gdk-task.md)
* [간단한 작업 실행](https://docs.xbox.com/ko/build/core-features/common/async/async-libraries/async-library-xasync-example-run-simple-task.md)
* [XAsync 라이브러리 개요](https://docs.xbox.com/ko/build/core-features/common/async/async-libraries/async-library-xasync.md)
* [취소 가능성 설정](https://docs.xbox.com/ko/build/core-features/common/async/async-libraries/async-library-xasyncprovider-example-setup-cancelability.md)
* [사용자 지정 공급자 설정](https://docs.xbox.com/ko/build/core-features/common/async/async-libraries/async-library-xasyncprovider-example-setup-custom-provider.md)
* [비동기 프로그래밍 모델](https://docs.xbox.com/ko/build/core-features/common/async/async-programming-model.md)
* [일반 비동기 작업 래퍼](https://docs.xbox.com/ko/build/core-features/common/async/async-task-function-example.md)

## 함께 보기

[XAsync 멤버](https://docs.xbox.com/ko/reference/system/xasync/xasync_members.md)\
[XAsyncProvider 멤버](https://docs.xbox.com/ko/reference/system/xasyncprovider/xasyncprovider_members.md)\
[비동기 프로그래밍 모델](https://docs.xbox.com/ko/build/core-features/common/async/async-programming-model.md)


## Related topics

- [XAsyncWork](https://docs.xbox.com/ko/reference/system/xasync/functions/xasyncwork.md)
- [간단한 작업 실행 예제](https://docs.xbox.com/ko/build/core-features/common/async/async-libraries/async-library-xasync-example-run-simple-task.md)
- [XAsync (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xasync/xasync_members.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync](https://docs.xbox.com/ko/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasync.md)
- [일반 비동기 작업 래퍼](https://docs.xbox.com/ko/build/core-features/common/async/async-task-function-example.md)