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

# 執行簡單工作範例

> 執行簡單工作範例

本主題提供如何執行簡單使用者工作的範例。簡單工作可以使用 [XAsyncRun](/zh-TW/reference/system/xasync/functions/xasyncrun) 函式啟動。
此函式會接受非同步區塊作為輸入，然後需要
以 functor 或 lambda 輸入的形式實作工作回呼。請記住，
非同步區塊會指定要使用的工作佇列以及選用的
完成回呼。

```c++ theme={null}
XAsyncBlock* async = new XAsyncBlock{};
async->queue = taskQueue;
async->context = contextData;
async->callback = 
    [](XAsyncBlock* async)
    {
        // The optional completion callback.
        delete async;
    }

XAsyncRun(async,
    [](XAsyncBlock* async)->HRESULT
    {
        // The work callback is implemented here.
        return S_OK;
    });
```

此範例使用 `XAsyncRun` 來啟動自訂的簡單
非同步工作。非同步區塊包含要使用的工作佇列以及
完成回呼。
`XAsyncRun` 需要工作回呼，而且
它具有傳回值。之後可透過呼叫
[XAsyncGetStatus](/zh-TW/reference/system/xasync/functions/xasyncgetstatus) 傳回該值。在內部，`XAsyncRun`
具有簡單的非同步提供者設定，可處理將指定工作回呼加入佇列、
將非同步區塊中的完成回呼加入佇列，
以及此程序的其他狀態變更。這表示執行簡單的非同步工作時
不需要額外的程式碼，只要設定
非同步區塊並呼叫 `XAsyncRun` 即可。

## 參考 API 文件

* [XAsync (API 內容)](/zh-TW/reference/system/xasync/xasync_members)
  * 函式
    * [XAsyncRun](/zh-TW/reference/system/xasync/functions/xasyncrun)
    * [XAsyncGetStatus](/zh-TW/reference/system/xasync/functions/xasyncgetstatus)

## 另請參閱

[XAsync 程式庫概觀](/zh-TW/build/core-features/common/async/async-libraries/async-library-xasync)

[設定非同步工作 (範例)](/zh-TW/build/core-features/common/async/async-libraries/async-library-xasync-example-setup-async-task)

[執行 Microsoft Game Development Kit (GDK) API 工作 (範例)](/zh-TW/build/core-features/common/async/async-libraries/async-library-xasync-example-run-gdk-task)

[XAsync](/zh-TW/reference/system/xasync/xasync_members)


## Related topics

- [GDK 範例](/zh-TW/home/setup-install/samples.md)
- [使用 GDKX 建置並執行你的第一個主機遊戲](/zh-TW/home/build-first-title/first-console-title-walkthrough.md)
- [Direct3D 12 程式設計指南](/zh-TW/build/gdk-and-engines/guides/directx-12-programming-guide.md)
- [XBOX 主機遊戲的認證測試 XBOX 需求](/zh-TW/publishing/certification/console-cert-tested-requirements.md)
- [XBOX 遊戲的 XBOX 需求](/zh-TW/publishing/certification/xbox-requirements.md)