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

# OMSetSampleMaskX (XBOX Series 主機)

> 為 2 x 2 像素四邊形中的每個樣本設定樣本啟用遮罩

為 2 x 2 像素四邊形中的每個樣本設定樣本啟用遮罩。此值會覆寫圖形管線狀態物件所設定的樣本遮罩。

## 語法

```cpp theme={null}
void OMSetSampleMaskX(  
    UINT64 QuadSampleMask  
)  
```

### 參數

*QuadSampleMask*

類型：UINT64

為 2 x 2 像素四邊形中的每個像素指定 16 位元的樣本啟用遮罩。

## 備註

此 XBOX 擴充 API 會為 2 x 2 像素四邊形中的每個像素設定樣本遮罩。
請注意，使用 ID3D12GraphicsCommandList::SetPipelineState 設定新的圖形管線狀態物件時，會將樣本遮罩重設為該管線狀態物件所指定的遮罩。
因此，一律應在呼叫 SetPipelineState 之後呼叫 OMSetSampleMaskX。

圖形管線狀態物件的樣本遮罩會套用至像素四邊形中的 4 個像素。
OMSetSampleMaskX 可以為像素四邊形中的 4 個像素各自指定唯一的遮罩。

## 需求

**標頭：** d3d12\_xs.h

**程式庫：** d3d12\_xs.lib\
**支援的平台：** XBOX Series 主機

## 另請參閱

[ID3D12GraphicsCommandList6](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/id3d12graphicscommandlist6)


## Related topics

- [使用 GDKX 建置並執行你的第一個主機遊戲](/zh-TW/home/build-first-title/first-console-title-walkthrough.md)
- [SetViewInstanceMask](/es/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/methods/id3d12graphicscommandlist1_setviewinstancemask_public.md)
- [chat_manager::set_thread_affinity_mask](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_set_thread_affinity_mask.md)