XTaskQueueTerminate
보류 중인 모든 항목을 취소하고 새 항목이 큐에 추가되지 않도록 하여 작업 큐를 종료합니다.구문
매개 변수
queue _In_형식: XTaskQueueHandle 종료할 큐입니다. wait _In_
형식: bool 종료가 완료될 때까지 기다리려면 true입니다. callbackContext _In_opt_
형식: void* 콜백에 전달할 선택적 컨텍스트 포인터입니다. callback _In_opt_
형식: XTaskQueueTerminatedCallback* 큐가 종료되면 호출될 선택적 콜백입니다.
반환 값
형식: HRESULT HRESULT 성공 또는 오류 코드입니다.설명
이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
- 두 포트의 모든 콜백이 canceled 매개 변수를 true로 설정하여 호출됩니다.
- 작업 포트에서 보류 중인 모든 콜백이 디스패치됩니다. 작업 포트에 새 콜백을 제출하면 E_ABORT로 실패합니다.
- 완료 포트에서 보류 중인 모든 콜백이 디스패치됩니다. 완료 포트에 새 콜백을 제출하면 E_ABORT로 실패합니다.
- XTaskQueueTerminate는 큐 핸들을 닫지 않습니다. 종료 후에도 XTaskQueueCloseHandle을 호출해야 합니다.
- XTaskQueueDispatch를 호출하여 큐 콜백을 처리하는 스레드에서 XTaskQueueTerminate를 호출하는 경우, wait 매개 변수에 true를 전달하지 마세요. 그렇지 않으면 코드에서 교착 상태가 발생할 수 있습니다.
SubmitCallback은 XTaskQueueSubmitCallback 함수에 대한 코드 예제에서 정의된 도우미 함수입니다.
요구 사항
헤더: XTaskQueue.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔개념 문서
함께 보기
XTaskQueue 멤버비동기 프로그래밍 모델
비동기 작업 큐 디자인
