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

# 방법: 작업 큐 대기자 사용

> 방법: 작업 큐 대기자 사용

## 예제

작업 큐에 Win32 커널 핸들을 등록할 수 있습니다. 핸들이 신호를 받으면 콜백이 큐에 제출됩니다. 일반적으로 신호에 사용할 자동 재설정 이벤트를 만듭니다. 핸들이 자동 재설정이 아닌 경우, 핸들이 신호를 받는 동안 현재 콜백이 완료되면 새 콜백이 제출됩니다.

다음 예에서는 작업 큐 대기자를 사용하는 방법을 보여 줍니다.

```c++ theme={null}
void CreatingTaskQueueWaiter()  
{  
    HANDLE waitEvent = CreateEvent(nullptr, FALSE, FALSE, nullptr);  
    if (waitEvent == nullptr)  
    {  
        printf("Error creating wait handle: %d\r\n", GetLastError());  
        return;  
    }  
  
    XTaskQueueHandle queue;  
  
    HRESULT hr = XTaskQueueCreate(  
        XTaskQueueDispatchMode::ThreadPool,  
        XTaskQueueDispatchMode::ThreadPool,  
        &queue);  
  
    if (FAILED(hr))  
    {  
        printf("Error creating task queue: %x\n", hr);  
        CloseHandle(waitEvent);  
        return;  
    }  
  
    auto callback = [](void*, bool)  
    {  
        printf("Callback invoked.\r\n");  
    };  
  
    XTaskQueueRegistrationToken token;  
  
    hr = XTaskQueueRegisterWaiter(  
        queue,  
        XTaskQueuePort::Completion,  
        waitEvent,  
        nullptr,  
        callback,  
        &token);  
  
    if (FAILED(hr))  
    {  
        printf("Error registering task queue waiter: %x\n", hr);  
        CloseHandle(waitEvent);  
        XTaskQueueCloseHandle(queue);  
        return;  
    }  
  
    // Now, whenever our wait event becomes signaled, the callback will be called.  
    for (uint32_t i = 0; i < 5; i++)  
    {  
        SetEvent(waitEvent);  
        Sleep(100);  
    }  
  
    // Note: Unregistering the waiter is optional.  
    XTaskQueueUnregisterWaiter(queue, token);  
    XTaskQueueCloseHandle(queue);  
    CloseHandle(waitEvent);  
}  
```

## 샘플 출력

```
Callback invoked.  
Callback invoked.  
Callback invoked.  
Callback invoked.  
Callback invoked.  
```

## 참고 항목

[작업 큐 설계](/build/core-features/common/async/async-task-queue-design)


## Related topics

- [방법: 프로세스 작업 큐 사용](/ko/build/core-features/common/async/async-task-queue-design-howto/using-process-task-queue.md)
- [방법: Windows 메시지 루프와 함께 작업 큐 사용](/ko/build/core-features/common/async/async-task-queue-design-howto/task-queue-windows-msg-loop.md)
- [비동기 작업 큐 설계](/ko/build/core-features/common/async/async-task-queue-design.md)
- [XTaskQueueUnregisterWaiter](/ko/reference/system/xtaskqueue/functions/xtaskqueueunregisterwaiter.md)
- [작업 큐 정리 예제](/ko/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue.md)