XTaskQueueDispatch
지정된 포트에 대한 작업 큐의 항목을 처리합니다.구문
매개 변수
queue _In_형식: XTaskQueueHandle 작업을 디스패치할 큐입니다. port _In_
형식: XTaskQueuePort 디스패치할 포트입니다. timeoutInMs _In_
형식: uint32_t false를 반환하기 전에 작업이 도착할 때까지 기다릴 밀리초 수입니다. INFINITE를 전달하여 영원히 기다릴 수 있습니다.
반환 값
형식: bool 이 함수가 호출을 디스패치한 경우 true를 반환하고, 그렇지 않으면 false를 반환합니다. 이 함수는 시간 제한으로 INFINITE가 전달되더라도 큐가 종료된 경우 false를 반환합니다.설명
시간 제한을 전달할 수 있으며, 이는 XTaskQueueDispatch가 큐에 무언가가 도착할 때까지 기다리도록 합니다. 작업 큐 포트가 XTaskQueueDispatchMode::ThreadPool, XTaskQueueDispatchMode::SerializedThreadPool 또는 XTaskQueueDispatchMode::Immediate 디스패치 모드로 생성된 경우 콜백을 자동으로 디스패치합니다. 수동 디스패치 포트의 경우 XTaskQueueDispatch를 호출해야 합니다. XTaskQueueDispatch는 어떤 디스패치 모드에 대해서도 호출할 수 있지만, 호출은 항상 XTaskQueueDispatch를 호출하는 스레드에서 디스패치됩니다.업스트림 코드의 성능 요구 사항을 충족하려면 큐에 항목을 추가하는 작업이 잠금 없이 대기 없이 수행되어야 합니다. 다음 API는 잠금 프리(lock free)입니다.
- XTaskQueueSubmitCallback
- XTaskQueueSubmitDelayedCallback
- XTaskQueueDispatch는 timeoutInMs에 0이 전달된 경우
XTaskQueueDispatch가 작업 포트의 항목을 처리하는 데 소요되는 시간은 가변적이며 수행되는 작업에 따라 달라집니다. 경우에 따라 호출 스레드가 다른 시스템 작업이 완료될 때까지 기다리기 위해 차단될 수 있습니다. 다음 예제에서는 XTaskQueueDispatch 함수를 사용하여 작업 큐의 항목을 처리하는 방법을 보여 줍니다.
SubmitCallback은 XTaskQueueSubmitCallback 함수에 대한 코드 예제에서 정의된 도우미 함수입니다.
요구 사항
헤더: XTaskQueue.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔개념 문서
함께 보기
XTaskQueue 멤버비동기 프로그래밍 모델
비동기 작업 큐 디자인
