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

# XTaskQueueDispatchMode

> XTaskQueueDispatchMode

# XTaskQueueDispatchMode

작업 큐 콜백을 처리하는 방식을 설명합니다.

## 구문

```cpp theme={null}
typedef enum class XTaskQueueDispatchMode  : uint32_t  
{  
    Manual,  
    ThreadPool,  
    SerializedThreadPool,  
    Immediate  
} XTaskQueueDispatchMode  
```

## 상수

| 상수                   | 설명                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Manual               | 콜백이 자동으로 디스패치되지 않습니다. 이 디스패치 모드를 사용하여 포트에 제출된 콜백은 큐에 넣어지지만, [XTaskQueueDispatch](/reference/system/xtaskqueue/functions/xtaskqueuedispatch)를 통해 수동으로 디스패치되어야 합니다.<br />**참고:** Windows 메시지를 펌프하는 스레드가 있는 경우:<ul><li>작업 포트에 대한 콜백을 디스패치하지 마세요.</li><li>완료 포트에 대한 콜백을 디스패치하는 경우 해당 스레드에 대해 Windows 메시지를 계속 펌프해야 합니다.</li></ul><br />자세한 내용은 [수동 작업 큐 만들기](/build/core-features/common/async/async-task-queue-design-howto/creating-manual-task-queue)를 참조하세요. |
| ThreadPool           | 이 디스패치 모드를 사용하여 포트에 제출된 콜백은 큐에 넣어지고 시스템 스레드 큐에서 자동으로 디스패치됩니다. 작업 큐는 스레드 풀 스레드를 사용할 수 있게 되면 작업 큐에서 실행할 호출을 차례로 가져와 호출을 병렬로 실행합니다.<br />스레드 풀 작업 큐 만들기에 대한 자세한 내용은 [스레드 풀 작업 큐 만들기](/build/core-features/common/async/async-task-queue-design-howto/creating-thread-pool-task-queue)를 참조하세요.                                                                                                                                                                  |
| SerializedThreadPool | 이 디스패치 모드를 사용하여 포트에 제출된 콜백은 큐에 넣어지고 시스템 스레드 큐에서 자동으로 디스패치됩니다. `ThreadPool`과 달리 작업 큐는 호출을 스레드 풀에서 한 번에 하나씩 직렬로 실행합니다.                                                                                                                                                                                                                                                                                                                                        |
| Immediate            | 콜백이 큐에 넣어지지 않고 제출한 스레드에서 즉시 실행됩니다. 즉시 디스패치 모드를 구현하는 예제는 [복합 작업 큐 만들기](/build/core-features/common/async/async-task-queue-design-howto/creating-composite-task-queue)를 참조하세요.                                                                                                                                                                                                                                                                                |

## 설명

이 열거형은 [XTaskQueueCreate](/reference/system/xtaskqueue/functions/xtaskqueuecreate)에서 작업 큐의 작업 포트 및 완료 포트에 대한 디스패치 모드를 지정하는 데 사용됩니다.

작업 포트와 완료 포트는 서로 다른 디스패치 모드를 사용할 수 있습니다. 예를 들어 작업 포트에는 스레드 풀 디스패치 모드를 사용하여 시스템 스레드 큐에서 콜백을 자동으로 큐에 넣고 병렬로 실행하고, 완료 포트에는 수동 디스패치 모드를 사용하여 Windows 메시지 루프 스레드에서 콜백을 수동으로 큐에 넣고 실행할 수 있습니다. 자세한 내용은 [Windows 메시지 루프에서 작업 큐 사용](/build/core-features/common/async/async-task-queue-design-howto/task-queue-windows-msg-loop)을 참조하세요.

## 요구 사항

**헤더:** XTaskQueue.h

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

## 함께 보기

[XTaskQueue 멤버](/reference/system/xtaskqueue/xtaskqueue_members)\
[비동기 프로그래밍 모델](/build/core-features/common/async/async-programming-model)\
[비동기 작업 큐 디자인](/build/core-features/common/async/async-task-queue-design)


## Related topics

- [XTaskQueueCreate](/ko/reference/system/xtaskqueue/functions/xtaskqueuecreate.md)
- [XTaskQueueDispatch](/ko/reference/system/xtaskqueue/functions/xtaskqueuedispatch.md)
- [XTaskQueue](/ko/reference/system/xtaskqueue/xtaskqueue_members.md)
- [PlayFab Unified SDK에서 비동기 호출 수행](/ko/services/playfab/sdks/unified-sdk/async-model.md)
- [비동기 호출 만들기](/ko/services/playfab/sdks/c/async.md)