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

# SetEventOnMultipleFenceCompletion

> 指定當一組柵欄中的一或多個柵欄達到特定值時應引發的事件。

指定當一組柵欄中的一或多個柵欄達到特定值時應引發的事件。

## 語法

```cpp theme={null}
HRESULT SetEventOnMultipleFenceCompletion(
    ID3D12Fence const  ppFences,
    const UINT64  pFenceValues,
    UINT NumFences,
    D3D12_MULTIPLE_FENCE_WAIT_FLAGS Flags,
    HANDLE hEvent
)
```

### 參數

*ppFences \[in]*\
類型：ID3D12Fence \*const \*

長度為 <i>NumFences</i> 的陣列，指定 [ID3D12Fence](/zh-TW/reference/graphics/d3d12/interfaces/id3d12fence/id3d12fence_public) 物件。

*pFenceValues \[in]*\
類型：const UINT64 \*

長度為 <i>NumFences</i> 的陣列，指定發出事件訊號所需的柵欄值。

*NumFences*\
類型：UINT

指定要包含的柵欄數目。

*Flags*\
類型：D3D12\_MULTIPLE\_FENCE\_WAIT\_FLAGS

指定其中一個 [D3D12\_MULTIPLE\_FENCE\_WAIT\_FLAGS](/zh-TW/reference/graphics/d3d12/enums/d3d12_multiple_fence_wait_flags_public)，以決定如何繼續進行。

*hEvent*\
類型：HANDLE

事件物件的控制代碼。

### 傳回值

類型：HRESULT

此方法會傳回 HRESULT 成功或錯誤碼。

## 備註

若要指定單一柵欄，請參閱 [SetEventOnCompletion](/zh-TW/reference/graphics/d3d12/interfaces/id3d12fence/methods/id3d12fence_seteventoncompletion_public) 方法。

如果 *hEvent* 是 null 控制代碼，則此 API 在達到指定的柵欄值之前不會傳回。

## 需求

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

## 另請參閱

[ID3D12Device1](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device1/id3d12device1_public)


## Related topics

- [D3D12_MULTIPLE_FENCE_WAIT_FLAGS](/zh-TW/reference/graphics/d3d12/enums/d3d12_multiple_fence_wait_flags_public.md)
- [SetEventOnCompletion](/zh-TW/reference/graphics/d3d12/interfaces/id3d12fence/methods/id3d12fence_seteventoncompletion_public.md)
- [DirectStorage 概觀](/zh-TW/build/console-features/storage/directstorage/directstorage-overview.md)
- [Wait](/zh-TW/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_wait_public.md)
- [GetDeviceRemovedReason](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_getdeviceremovedreason_public.md)