Skip to main content

XTaskQueueRegisterWaiter

작업 큐에 대기 핸들을 등록합니다.

구문

매개 변수

queue   _In_
형식: XTaskQueueHandle
콜백을 제출할 큐입니다. port   _In_
형식: XTaskQueuePort
콜백을 제출할 포트입니다. 콜백은 작업 또는 완료 포트에 할당할 수 있습니다. waitHandle   _In_
형식: HANDLE
모니터링할 핸들입니다.
이는 신호를 받을 때 콜백을 호출할 대기 핸들입니다. 대기 핸들은 일반적으로 자동 또는 수동 재설정 이벤트입니다. 대기 핸들이 수동 재설정인 경우 이벤트가 신호를 받는 한 콜백이 반복적으로 호출됩니다. 원하지 않는 동작이라면 콜백 내에서 이벤트를 재설정하거나 대기 콜백의 등록을 해제하세요.
callbackContext   _In_opt_
형식: void*
콜백에 전달될 선택적 컨텍스트 포인터입니다. callback   _In_
형식: XTaskQueueCallback*
콜백 함수에 대한 포인터입니다. token   _Out_
형식: XTaskQueueRegistrationToken*
등록 토큰입니다. 대기 등록을 해제하기 위해 XTaskQueueUnregisterWaiter에 전달할 수 있습니다.

반환 값

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

설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
대기 핸들이 충족되면 작업 큐가 주어진 콜백을 호출합니다. 이는 핸들이 신호를 받는 것에 대한 응답으로 작업 큐에 항목을 추가하는 효율적인 방법을 제공합니다. 다음 예제에서는 Win32 커널 핸들을 작업 큐에 등록합니다. 핸들이 신호를 받으면 콜백이 큐에 제출됩니다. 일반적으로 신호를 위한 자동 재설정 이벤트를 만듭니다. 핸들이 자동 재설정이 아닌 경우 핸들이 신호를 받는 동안 현재 콜백이 완료되면 새 콜백이 제출됩니다.

요구 사항

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

개념 문서

함께 보기

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