> ## 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.

# XTaskQueue 라이브러리 개요

> XTaskQueue 라이브러리가 작업의 실행 시기와 위치를 제어하는 방식과 포트 디스패치 모드, 기본 프로세스 작업 큐, XTaskQueueHandle에 대해 알아봅니다.

이 항목을 사용하여 XTaskQueue 라이브러리로 작업 큐를 관리합니다. 이 라이브러리는 작업 실행의 "언제"와 "어디서"를 담당하며, 이는 작업 큐 및 작업 큐를 [설정](https://docs.xbox.com/ko/reference/system/xtaskqueue/functions/xtaskqueuecreate.md), [관리](https://docs.xbox.com/ko/reference/system/xtaskqueue/functions/xtaskqueuedispatch.md), [제어](https://docs.xbox.com/ko/reference/system/xtaskqueue/functions/xtaskqueueregistermonitor.md)하는 메서드로 제어됩니다.

작업 큐에는 [다양한 모드](https://docs.xbox.com/ko/reference/system/xtaskqueue/enums/xtaskqueuedispatchmode.md)로 설정된 두 개의 포트를 가질 수 있으며 임의의 스레드에서 디스패치할 수 있습니다. [사용자 지정 콜백](https://docs.xbox.com/ko/reference/system/xtaskqueue/functions/xtaskqueueregisterwaiter.md)을 추가하여 특수한 상황에서 기능을 호출할 수 있습니다.

각 프로세스에는 시스템 스레드 풀에서 작업을 자동으로 동시에 디스패치하는 기본 작업 큐가 있습니다. [XAsyncBlock](https://docs.xbox.com/ko/reference/system/xasync/structs/xasyncblock.md)에 작업 큐가 지정되지 않으면 이 작업 풀이 사용됩니다. 기본 작업 큐를 [변경하거나 제거](https://docs.xbox.com/ko/reference/system/xtaskqueue/functions/xtaskqueuesetcurrentprocesstaskqueue.md)할 수 있습니다.

XTaskQueue API에 대한 자세한 내용은 [XTaskQueue](https://docs.xbox.com/ko/reference/system/xtaskqueue/xtaskqueue_members.md)를 참조하세요.

## XTaskQueueHandle

작업 큐가 만들어지면 `XTaskQueueHandle` 형식으로 추적됩니다. 이 핸들은 작업 큐를 식별하며 작업 큐를 다루는 [XTaskQueue 라이브러리](https://docs.xbox.com/ko/reference/system/xtaskqueue/xtaskqueue_members.md)의 모든 함수에 전달됩니다. 핸들은 추적되어야 하며 작업 큐를 더 이상 사용하지 않을 때 닫아야 합니다.

작업 큐 정리에 대한 자세한 내용은 [작업 큐 정리](https://docs.xbox.com/ko/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue.md)를 참조하세요.

## 참고 API 문서

* [XTaskQueue(API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xtaskqueue/xtaskqueue_members.md)
  * 함수
    * [xtaskqueuecreate](https://docs.xbox.com/ko/reference/system/xtaskqueue/functions/xtaskqueuecreate.md)
    * [xtaskqueuedispatch](https://docs.xbox.com/ko/reference/system/xtaskqueue/functions/xtaskqueuedispatch.md)
    * [xtaskqueueregistermonitor](https://docs.xbox.com/ko/reference/system/xtaskqueue/functions/xtaskqueueregistermonitor.md)
    * [xtaskqueueregisterwaiter](https://docs.xbox.com/ko/reference/system/xtaskqueue/functions/xtaskqueueregisterwaiter.md)
    * [xtaskqueuesetcurrentprocesstaskqueue](https://docs.xbox.com/ko/reference/system/xtaskqueue/functions/xtaskqueuesetcurrentprocesstaskqueue.md)
* [xasync(API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xasync/xasync_members.md)
  * 구조체
    * [XAsyncBlock](https://docs.xbox.com/ko/reference/system/xasync/structs/xasyncblock.md)

## 참고 항목

[예제: 작업 큐 만들기](https://docs.xbox.com/ko/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-create-task-queue.md)
[예제: 작업 큐 디스패치](https://docs.xbox.com/ko/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-dispatch-task-queue.md)
[예제: 작업 큐 정리](https://docs.xbox.com/ko/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue.md)
[XAsync](https://docs.xbox.com/ko/reference/system/xasync/xasync_members.md)
[작업 큐 설계](https://docs.xbox.com/ko/build/core-features/common/async/async-task-queue-design.md)
[XTaskQueue](https://docs.xbox.com/ko/reference/system/xtaskqueue/xtaskqueue_members.md)


## Related topics

- [XTaskQueue (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xtaskqueue/xtaskqueue_members.md)
- [XTaskQueueRegisterWaiter](https://docs.xbox.com/ko/reference/system/xtaskqueue/functions/xtaskqueueregisterwaiter.md)
- [XTaskQueueRegisterMonitor](https://docs.xbox.com/ko/reference/system/xtaskqueue/functions/xtaskqueueregistermonitor.md)
- [XTaskQueueSetCurrentProcessTaskQueue](https://docs.xbox.com/ko/reference/system/xtaskqueue/functions/xtaskqueuesetcurrentprocesstaskqueue.md)
- [XTaskQueueMonitorCallback](https://docs.xbox.com/ko/reference/system/xtaskqueue/functions/xtaskqueuemonitorcallback.md)