Skip to main content

XTaskQueueSubmitCallback

지정된 포트에 대한 큐에 콜백을 제출합니다.

구문

매개 변수

queue   _In_
형식: XTaskQueueHandle
콜백을 제출할 큐입니다. port   _In_
형식: XTaskQueuePort
콜백을 제출할 포트입니다. 콜백은 작업 또는 완료 포트에 할당할 수 있습니다. callbackContext   _In_opt_
형식: void*
콜백에 전달될 선택적 컨텍스트 포인터입니다. callback   _In_
형식: XTaskQueueCallback*
콜백 함수에 대한 포인터입니다.

반환 값

형식: HRESULT HRESULT 성공 또는 오류 코드입니다.

설명

alert 성능 참고 사항:
업스트림 코드의 성능 요구 사항을 충족하려면 큐에 항목을 추가하는 작업이 잠금 없이 대기 없이 수행되어야 합니다. 다음 API는 잠금 프리(lock free)입니다.
다음 예제에서는 콜백을 작업 큐의 작업 또는 완료 포트 중 하나에 제출하는 방법을 보여 줍니다. 먼저 작업 콜백을 제출한 다음 작업 콜백의 끝에서 완료 콜백을 제출하는 것이 일반적입니다.

요구 사항

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

함께 보기

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