Skip to main content

XTaskQueueSetCurrentProcessTaskQueue

지정된 작업 큐를 프로세스 전체 작업 큐로 설정합니다.

구문

매개 변수

queue   _In_
형식: XTaskQueueHandle
프로세스의 기본 작업 큐로 설정할 큐입니다.

반환 값

형식: void

설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
큐를 nullptr로 설정할 수 있으며, 이 경우 XTaskQueueGetCurrentProcessTaskQueue도 nullptr을 반환합니다. 제공된 큐의 핸들이 복제되고 기존 프로세스 작업 큐가 있다면 그 핸들은 닫힙니다. 다음 예제에서는 기본 프로세스 작업 큐를 대체합니다. 이 작업 큐는 작업 및 완료 디스패치 모두에 스레드 풀을 사용합니다. 작업 큐 매개 변수를 사용하는 Microsoft GDK(Game Development Kit) API는 모두 nullptr을 허용하며 프로세스 작업 큐로 대체합니다. 프로세스 작업 큐를 nullptr로 설정할 수도 있으며, 이 경우 작업 큐 매개 변수가 필요한 Microsoft GDK(Game Development Kit) API는 null이 제공되면 E_NO_TASK_QUEUE 오류가 발생합니다. 이렇게 하면 Microsoft GDK(Game Development Kit) API가 기본값으로 작동하는 동시에 필요한 경우 작업 큐 핸들에 대한 엄격한 제어를 유지할 수 있습니다.

요구 사항

헤더: XTaskQueue.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

개념 문서

함께 보기

XTaskQueue 멤버
비동기 프로그래밍 모델
비동기 작업 큐 디자인
마지막 수정일 2026년 8월 24일