XAsyncCompletionRoutine
비동기 호출에 대한 완료 콜백을 나타냅니다.
구문
void XAsyncCompletionRoutine(
XAsyncBlock* asyncBlock
)
매개 변수
asyncBlock _Inout_
형식: XAsyncBlock*
완료 콜백을 위한 XAsyncBlock에 대한 포인터입니다.
반환 값
형식: void
비고
필요에 따라 XAsyncCompletionRoutine 포인터를 지정하여 비동기 호출에 대한 완료 콜백를 제공할 수 있습니다. 완료 콜백은 비동기 호출을 완료한 후 실행되는 콜백 함수입니다. 비동기 호출에 대한 XAsyncBlock 구조체의 callback 멤버에 XAsyncCompletionRoutine 포인터를 지정할 수 있습니다.
일반적으로 완료 콜백은 다른 스레드에 있는 비동기 호출의 결과를 처리합니다. 완료 콜백은 비동기 호출이 완료될 때 호출되는 콜백 함수를 나타냅니다. 콜백 함수는 이후에 콜백 함수의 결과를 획득하는 데 사용되는 XAsyncBlock 포인터를 가져옵니다.
완료 콜백을 지정하지 않은 경우 XAsyncGetStatus 함수를 사용하여 완료 콜백이 완료되었는지 주기적으로 확인한 다음, 필요에 따라 XAsyncGetResult 및 XAsyncGetResultSize를 사용하여 완료된 작업의 결과를 가져올 수 있습니다.
XAsyncCancel이 비동기 호출을 취소하려고 호출되어도 완료 콜백은 호출됩니다.
비동기 호출의 결과를 획득하려면 XAsyncGetStatus 또는 완료 콜백의 Get\*Result 메서드를 사용합니다. 비동기 호출이 취소된 경우 이 메서드는 E_ABORT을(를) 반환합니다.
Get\*Result 메서드를 포함한 비동기 공급자의 구현 패턴에 대한 자세한 내용은 비동기 프로그래밍 모델을 참조하십시오.
요구 사항
헤더: XAsync.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔