> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XAsyncCompletionRoutine

> XAsyncCompletionRoutine

# XAsyncCompletionRoutine

表示异步调用的完成回调。

## Syntax

```cpp theme={null}
void XAsyncCompletionRoutine(  
         XAsyncBlock* asyncBlock  
)  
```

### Parameters

*asyncBlock*   \_Inout\_\
类型：[XAsyncBlock\*](https://docs.xbox.com/zh-CN/reference/system/xasync/structs/xasyncblock.md)

指向该完成回调的 [XAsyncBlock](https://docs.xbox.com/zh-CN/reference/system/xasync/structs/xasyncblock.md) 的指针。

### Return value

类型：void

## Remarks

可以选择指定一个 `XAsyncCompletionRoutine` 指针来为异步调用提供*完成回调*。完成回调是在异步调用完成后执行的回调函数。可以在异步调用的 [XAsyncBlock](https://docs.xbox.com/zh-CN/reference/system/xasync/structs/xasyncblock.md) 结构的 `callback` 成员中指定一个 `XAsyncCompletionRoutine` 指针。

通常，完成回调在另一线程上处理异步调用的结果。完成回调表示在异步调用完成时调用的回调函数。此回调函数采用一个 `XAsyncBlock` 指针，该指针随后用于获取回调函数的结果。

如果指定了完成回调，可以使用 [XAsyncGetStatus](https://docs.xbox.com/zh-CN/reference/system/xasync/functions/xasyncgetstatus.md) 函数定期检查完成回调是否已完成，然后根据需要使用 [XAsyncGetResult](https://docs.xbox.com/zh-CN/reference/system/xasyncprovider/functions/xasyncgetresult.md) 和 [XAsyncGetResultSize](https://docs.xbox.com/zh-CN/reference/system/xasync/functions/xasyncgetresultsize.md) 获取已完成任务的结果。

即使调用 [XAsyncCancel](https://docs.xbox.com/zh-CN/reference/system/xasync/functions/xasynccancel.md) 取消异步调用，也会调用完成回调。

使用 [XAsyncGetStatus](https://docs.xbox.com/zh-CN/reference/system/xasync/functions/xasyncgetstatus.md) 或完成回调的 `Get\*Result` 方法来获取异步调用的结果。如果异步调用已取消，这些方法将返回 `E_ABORT`。有关异步提供程序的实现模式（包括 `Get\*Result` 方法）的详细信息，请参阅[异步编程模型](https://docs.xbox.com/zh-CN/build/core-features/common/async/async-programming-model.md)。

## Requirements

**头文件：** XAsync.h

**库：** xgameruntime.lib

**受支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## Conceptual documentation

* [异步编程模型](https://docs.xbox.com/zh-CN/build/core-features/common/async/async-programming-model.md)

## See also

[XAsync Members](https://docs.xbox.com/zh-CN/reference/system/xasync/xasync_members.md)\
[XAsyncGetStatus](https://docs.xbox.com/zh-CN/reference/system/xasync/functions/xasyncgetstatus.md)\
[异步编程模型](https://docs.xbox.com/zh-CN/build/core-features/common/async/async-programming-model.md)


## Related topics

- [XAsyncCancel](https://docs.xbox.com/zh-CN/reference/system/xasync/functions/xasynccancel.md)
- [异步编程模型](https://docs.xbox.com/zh-CN/build/core-features/common/async/async-programming-model.md)
- [XAsync（API 内容）](https://docs.xbox.com/zh-CN/reference/system/xasync/xasync_members.md)
- [XAsyncBlock](https://docs.xbox.com/zh-CN/reference/system/xasync/structs/xasyncblock.md)
- [XMEMALLOC_ROUTINE callback](https://docs.xbox.com/zh-CN/reference/system/xmem/functions/xmemalloc_routine.md)