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

# DXGI_SWAP_CHAIN_FLAG (XBOX Series 主機)

> 交換鏈行為的選項。

交換鏈行為的選項。

## 語法

```cpp theme={null}
typedef enum DXGI_SWAP_CHAIN_FLAG    
{  
    DXGI_SWAP_CHAIN_FLAG_NONPREROTATED = 1,  
    DXGI_SWAP_CHAIN_FLAG_ALLOW_MODE_SWITCH = 2,  
    DXGI_SWAP_CHAIN_FLAG_GDI_COMPATIBLE = 4,  
    DXGI_SWAP_CHAIN_FLAG_RESTRICTED_CONTENT = 8,  
    DXGI_SWAP_CHAIN_FLAG_RESTRICT_SHARED_RESOURCE_DRIVER = 16,  
    DXGI_SWAP_CHAIN_FLAG_DISPLAY_ONLY = 32,  
    DXGIX_SWAP_CHAIN_FLAG_QUANTIZATION_RGB_FULL = 0,  
    DXGIX_SWAP_CHAIN_FLAG_QUANTIZATION_RGB_LIMITED = 0x00100000,  
    DXGIX_SWAP_CHAIN_FLAG_COLORIMETRY_sRGB_TO_REC709 = 0x00200000,  
    DXGIX_SWAP_CHAIN_MATCH_OTHER_CONSOLES = ( DXGIX_SWAP_CHAIN_FLAG_QUANTIZATION_RGB_FULL ),  
    DXGIX_SWAP_CHAIN_MATCH_XBOX360_AND_PC = ( DXGIX_SWAP_CHAIN_FLAG_QUANTIZATION_RGB_FULL | DXGIX_SWAP_CHAIN_FLAG_COLORIMETRY_sRGB_TO_REC709 ),  
    DXGIX_SWAP_CHAIN_FLAG_COLORIMETRY_RGB_BT2020_ST2084 = 0x00800000,  
    DXGIX_SWAP_CHAIN_FLAG_AUTOMATIC_GAMEDVR_TONEMAP = 0x02000000,  
} DXGI_SWAP_CHAIN_FLAG  
```

## 常數

| 常數 | 描述 |
| - | - |
| DXGI\_SWAP\_CHAIN\_FLAG\_NONPREROTATED | 設定此旗標可關閉自動影像旋轉；也就是說，將前景緩衝區的內容傳輸至螢幕時不執行旋轉。 |
| 當應用程式預期自行處理旋轉時，請使用此旗標以避免頻寬損失。此選項只在全螢幕模式下有效。 | |
| DXGI\_SWAP\_CHAIN\_FLAG\_ALLOW\_MODE\_SWITCH | 設定此旗標可讓應用程式藉由呼叫 IDXGISwapChain::ResizeTarget 來切換模式。 |
| 從視窗模式切換至全螢幕模式時，顯示模式 (或螢幕解析度) 會變更為符合應用程式視窗的尺寸。 | |
| DXGI\_SWAP\_CHAIN\_FLAG\_GDI\_COMPATIBLE | 設定此旗標可讓應用程式在交換鏈或表面上使用 GDI 進行轉譯。<br />這可讓應用程式在第 0 個背景緩衝區或表面上呼叫 IDXGISurface1::GetDC。<br />此旗標不適用於 Direct3D 12。 |
| DXGI\_SWAP\_CHAIN\_FLAG\_RESTRICTED\_CONTENT | 設定此旗標以指出交換鏈可能包含受保護的內容；因此，作業系統只有在使用驅動程式和硬體保護時，才支援建立交換鏈。如果驅動程式和硬體不支援內容保護，為交換鏈建立資源的呼叫就會失敗。<br />Direct3D 11: 從 Windows 8 開始支援此列舉值。 |
| DXGI\_SWAP\_CHAIN\_FLAG\_RESTRICT\_SHARED\_RESOURCE\_DRIVER | 設定此旗標以指出在交換鏈內建立的共用資源，必須使用驅動程式限制存取共用表面的機制來加以保護。<br />Direct3D 11: 從 Windows 8 開始支援此列舉值。 |
| DXGI\_SWAP\_CHAIN\_FLAG\_DISPLAY\_ONLY | 設定此旗標可將呈現的內容限制在本機顯示器上。因此，無法透過遠端存取或桌面複製 API 存取呈現的內容。<br />此旗標支援 Windows 的視窗內容保護功能。應用程式可以使用此旗標，保護自己的螢幕視窗內容不會透過一組特定的公用作業系統功能和 API 遭到擷取或複製。<br />如果您將此旗標用於由其他處理序建立 HWND 的視窗型 (HWND 或 IWindow) 交換鏈，則 HWND 的擁有者必須適當地使用 SetWindowDisplayAffinity 函式，才能讓 IDXGISwapChain::Present 或 IDXGISwapChain1::Present1 的呼叫成功。<br />Direct3D 11: 從 Windows 8 開始支援此列舉值。 |
| DXGIX\_SWAP\_CHAIN\_FLAG\_QUANTIZATION\_RGB\_FULL | 已淘汰 |
| DXGIX\_SWAP\_CHAIN\_FLAG\_QUANTIZATION\_RGB\_LIMITED | 已淘汰 |
| DXGIX\_SWAP\_CHAIN\_FLAG\_COLORIMETRY\_sRGB\_TO\_REC709 | 已淘汰 |
| DXGIX\_SWAP\_CHAIN\_MATCH\_OTHER\_CONSOLES | 已淘汰 |
| DXGIX\_SWAP\_CHAIN\_MATCH\_XBOX360\_AND\_PC | 已淘汰 |
| DXGIX\_SWAP\_CHAIN\_FLAG\_COLORIMETRY\_RGB\_BT2020\_ST2084 | 已淘汰 |
| DXGIX\_SWAP\_CHAIN\_FLAG\_AUTOMATIC\_GAMEDVR\_TONEMAP | 已淘汰 |

## 備註

此列舉由 DXGI\_SWAP\_CHAIN\_DESC 結構和 IDXGISwapChain::ResizeTarget 方法使用。

此列舉也由 DXGI\_SWAP\_CHAIN\_DESC1 結構使用。

對於使用 IDXGIFactory::CreateSwapChain 方法以全螢幕模式建立的交換鏈，您不需要設定 DXGI\_SWAP\_CHAIN\_FLAG\_DISPLAY\_ONLY，因為這些交換鏈的行為已如同設定了 DXGI\_SWAP\_CHAIN\_FLAG\_DISPLAY\_ONLY。也就是說，無法透過遠端存取或桌面複製 API 存取呈現的內容。

使用 IDXGIFactory2::CreateSwapChainForHwnd、IDXGIFactory2::CreateSwapChainForCoreWindow 和 IDXGIFactory2::CreateSwapChainForComposition 方法建立的交換鏈，若未設定 DXGI\_SWAP\_CHAIN\_FLAG\_DISPLAY\_ONLY 則不受保護，若設定了 DXGI\_SWAP\_CHAIN\_FLAG\_DISPLAY\_ONLY 則受到保護。當交換鏈受到保護時，會防止螢幕擷取，而且在全螢幕模式下，無法透過桌面複製 API 存取呈現的內容。

當您呼叫 IDXGISwapChain::ResizeBuffers 來變更交換鏈的背景緩衝區時，可以重設或變更所有 DXGI\_SWAP\_CHAIN\_FLAG 旗標。

## 需求

**標頭:** d3d12\_xs.h\
**支援的平台**: XBOX Series 主機

## 另請參閱

[d3d12\_xs](/zh-TW/reference/graphics/d3d12_xs/d3d12_xs_members)


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [DXGI_ADAPTER_DESC2 (XBOX Series consoles)](/reference/graphics/d3d12_xs/structs/dxgi_adapter_desc2.md)
- [DXGI_ADAPTER_DESC2 (consolas XBOX Series)](/es/reference/graphics/d3d12_xs/structs/dxgi_adapter_desc2.md)
- [DXGI_ADAPTER_DESC2 (XBOX Series 主机)](/zh-CN/reference/graphics/d3d12_xs/structs/dxgi_adapter_desc2.md)
- [DXGI_ADAPTER_DESC2 (XBOX Series 콘솔)](/ko/reference/graphics/d3d12_xs/structs/dxgi_adapter_desc2.md)