Skip to main content

XAsyncCompletionRoutine

代表非同步呼叫的完成回呼。

語法

參數

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 主機

概念文件

另請參閱

XAsync 成員
XAsyncGetStatus
非同步程式設計模型
Last modified on October 6, 2026