다음을 통해 공유


XTaskQueueCallback

작업 큐에서 호출되는 콜백입니다.

구문

void XTaskQueueCallback(  
         void* context,  
         bool canceled  
)  

매개 변수

context _In_opt_
형식: void*

선택 사항. XTaskQueueSubmitCallback을 호출할 때 전달되는 컨텍스트 포인터.

canceled _In_
형식: bool

True 인 경우 작업 큐가 종료 되기 때문에 콜백이 취소됩니다.

반환 값

형식: void

비고

작업 큐에서 작업을 수행하기 위해 XTaskQueueCallback 콜백이 구현됩니다. 콜백은 XTaskQueueSubmitCallback 또는 XTaskQueueSubmitDelayedCallback를 호출하여 작업 큐의 작업 포트 또는 완료 포트에 제출할 수 있습니다. 작업 큐의 작업 포트 및 완료 포트에는 독립적인 디스패치 모드가 있을 수 있으며 XTaskQueueCallback 콜백은 어느 포트에 나 제출 될 수 있습니다. 일반적으로 작업 포트로 제출되는 콜백은 해당 작업이 완료되면 해당 콜백을 완료 포트로 제출합니다.

canceled 매개 변수의 목적은 콜백이 취소되는 경우 콜백에 할당된 모든 리소스를 올바르게 해제되게 하는 것입니다. XTaskQueueCallback 콜백이 호출되고 canceled이 true로 설정되면 XTaskQueueTerminate를 호출하여 해당 콜백에 대한 작업 큐가 종료되고 콜백이 취소됩니다. 콜백은 context에 할당 된 메모리를 포함하여 할당된 리소스를 해제하는 일 외에는 어떤 작업도 수행하지 않습니다.

예시는 콜백 제출을 참조하세요.

요구 사항

헤더: XTaskQueue.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

XTaskQueue 멤버
비동기 프로그래밍 모델
비동기 작업 큐 디자인