Skip to main content

XTaskQueueSubmitDelayedCallback

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

구문

매개 변수

queue   _In_
형식: XTaskQueueHandle
콜백을 제출할 큐입니다. port   _In_
형식: XTaskQueuePort
콜백을 제출할 포트입니다. 콜백은 작업 또는 완료 포트에 할당할 수 있습니다. delayMs   _In_
형식: uint32_t
콜백을 큐에 제출하기 전에 지연할 밀리초 수입니다.
콜백은 미래의 어느 시점에 큐에 추가되도록 제출될 수 있습니다. delayMs가 0이 아닌 경우 콜백은 보류 목록에 배치되고 다음으로 가장 가까운 대기 시간으로 타이머가 초기화됩니다. 시간이 경과하면 다음 시간을 가진 콜백이 실행 목록에 배치됩니다. 큐는 XTaskQueueMonitorCallback을 발생시키며, 큐가 스레드 풀 디스패치 모드에서 실행되는 경우 스레드 풀 작업이 제출됩니다.
callbackContext   _In_opt_
형식: void*
콜백에 전달될 선택적 컨텍스트 포인터입니다. callback   _In_
형식: XTaskQueueCallback*
콜백 함수에 대한 포인터입니다.

반환 값

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

설명

이 콜백은 delayMs밀리초 후에 큐에 추가됩니다. alert 성능 참고 사항:
업스트림 코드의 성능 요구 사항을 충족하려면 큐에 항목을 추가하는 작업이 잠금 없이 대기 없이 수행되어야 합니다. 다음 API는 잠금 프리(lock free)입니다.
다음 예제에서는 XTaskQueueSubmitDelayedCallback 함수를 사용하여 콜백을 미래에 제출할 수 있도록 허용합니다. 이는 짧은 지연 후 실패한 호출을 다시 시도하는 좋은 방법입니다. 또한 주기적 이벤트를 위한 저렴한 타이머로도 사용할 수 있습니다.
SubmitCallbackXTaskQueueSubmitCallback 함수에 대한 코드 예제에서 정의된 도우미 함수입니다.

요구 사항

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

함께 보기

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