> ## 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.

# Wait

> 將 GPU 端等候排入佇列，並立即傳回。GPU 端等候是指 GPU 會等到指定的柵欄達到或超過指定的值。

將 GPU 端等候排入佇列，並立即傳回。GPU 端等候是指 GPU 會等到指定的柵欄達到或超過指定的值。

## 語法

```cpp theme={null}
HRESULT Wait(
    ID3D12Fence  pFence,
    UINT64 Value
)
```

### 參數

*pFence*\
類型：ID3D12Fence \*

指向 [ID3D12Fence](/zh-TW/reference/graphics/d3d12/interfaces/id3d12fence/id3d12fence_public) 物件的指標。

*Value*\
類型：UINT64

命令佇列等候柵欄達到或超過的值。因此，當 [ID3D12Fence::GetCompletedValue](/zh-TW/reference/graphics/d3d12/interfaces/id3d12fence/methods/id3d12fence_getcompletedvalue_public) 大於或等於 <i>Value</i> 時，等候就會終止。

### 傳回值

類型：HRESULT

此方法會傳回其中一個 [Direct3D 12 傳回碼](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues)。

## 備註

由於等候是排入佇列，因此 API 會立即傳回。等候的是命令佇列 (在此期間不會執行任何工作)，直到指定的柵欄達到要求的值為止。

如果您想執行 CPU 端等候 (呼叫執行緒會封鎖，直到柵欄達到特定值為止)，則應將 [**ID3D12Fence::SetEventOnCompletion**](/zh-TW/reference/graphics/d3d12/interfaces/id3d12fence/methods/id3d12fence_seteventoncompletion_public) API 與 [**WaitForSingleObject**](https://learn.microsoft.com/en-us/windows/win32/api/synchapi/nf-synchapi-waitforsingleobject) (或類似的 API) 搭配使用。

## 需求

**標頭：** d3d12\_xs.h 或 d3d12\_x.h\
**程式庫：** d3d12\_xs.lib 或 d3d12\_x.lib\
**支援的平台**：XBOX Series 主機與 XBOX One 系列

## 另請參閱

[ID3D12CommandQueue](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/id3d12commandqueue_xs)

[多引擎同步處理](https://learn.microsoft.com/en-us/windows/win32/direct3d12/user-mode-heap-synchronization)


## Related topics

- [XtfWaitForConsoleState](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfwaitforconsolestate.md)
- [D3D12_MULTIPLE_FENCE_WAIT_FLAGS](/zh-TW/reference/graphics/d3d12/enums/d3d12_multiple_fence_wait_flags_public.md)
- [XblMultiplayerManagerEstimatedMatchWaitTime](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerestimatedmatchwaittime.md)
- [IGameInputDispatcher::OpenWaitHandle](/zh-TW/reference/input/gameinput/interfaces/IGameInputDispatcher/methods/igameinputdispatcher_openwaithandle.md)
- [XTaskQueueRegisterWaiter](/zh-TW/reference/system/xtaskqueue/functions/xtaskqueueregisterwaiter.md)