> ## 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 (consoles XBOX Series)

> Opções para o comportamento da cadeia de troca.

Opções para o comportamento da cadeia de troca.

## Sintaxe

```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  
```

## Constantes

| Constante | Descrição |
| - | - |
| DXGI\_SWAP\_CHAIN\_FLAG\_NONPREROTATED | Defina este sinalizador para desativar a rotação automática da imagem; ou seja, não realizar uma rotação ao transferir o conteúdo do buffer frontal para o monitor. |
| Use este sinalizador para evitar uma penalidade de largura de banda quando um aplicativo espera lidar com a rotação. Essa opção é válida somente no modo de tela inteira. | |
| DXGI\_SWAP\_CHAIN\_FLAG\_ALLOW\_MODE\_SWITCH | Defina este sinalizador para permitir que um aplicativo alterne modos chamando IDXGISwapChain::ResizeTarget. |
| Ao alternar do modo de janela para o modo de tela inteira, o modo de exibição (ou a resolução do monitor) será alterado para corresponder às dimensões da janela do aplicativo. | |
| DXGI\_SWAP\_CHAIN\_FLAG\_GDI\_COMPATIBLE | Defina este sinalizador para permitir que um aplicativo renderize usando GDI em uma cadeia de troca ou em uma superfície.<br />Isso permitirá que o aplicativo chame IDXGISurface1::GetDC no buffer de fundo 0 ou em uma superfície.<br />Este sinalizador não se aplica ao Direct3D 12. |
| DXGI\_SWAP\_CHAIN\_FLAG\_RESTRICTED\_CONTENT | Defina este sinalizador para indicar que a cadeia de troca pode conter conteúdo protegido; portanto, o sistema operacional dá suporte à criação da cadeia de troca somente quando a proteção de driver e de hardware é usada. Se o driver e o hardware não derem suporte à proteção de conteúdo, a chamada para criar um recurso para a cadeia de troca falhará. <br />Direct3D 11:  há suporte para este valor de enumeração a partir do Windows 8. |
| DXGI\_SWAP\_CHAIN\_FLAG\_RESTRICT\_SHARED\_RESOURCE\_DRIVER | Defina este sinalizador para indicar que os recursos compartilhados criados dentro da cadeia de troca devem ser protegidos usando o mecanismo do driver para restringir o acesso a superfícies compartilhadas.<br />Direct3D 11:  há suporte para este valor de enumeração a partir do Windows 8. |
| DXGI\_SWAP\_CHAIN\_FLAG\_DISPLAY\_ONLY | Defina este sinalizador para restringir o conteúdo apresentado às telas locais. Portanto, o conteúdo apresentado não fica acessível por meio de acesso remoto nem por meio das APIs de duplicação da área de trabalho.<br />Este sinalizador dá suporte aos recursos de proteção de conteúdo de janela do Windows. Os aplicativos podem usar este sinalizador para proteger o próprio conteúdo da janela na tela contra captura ou cópia por meio de um conjunto específico de recursos e APIs públicos do sistema operacional.<br />Se você usar este sinalizador com cadeias de troca em janela (HWND ou IWindow) em que outro processo criou o HWND, o proprietário do HWND deverá usar a função SetWindowDisplayAffinity adequadamente para permitir que as chamadas para IDXGISwapChain::Present ou IDXGISwapChain1::Present1 tenham êxito.<br />Direct3D 11:  há suporte para este valor de enumeração a partir do Windows 8. |
| DXGIX\_SWAP\_CHAIN\_FLAG\_QUANTIZATION\_RGB\_FULL | Preterido |
| DXGIX\_SWAP\_CHAIN\_FLAG\_QUANTIZATION\_RGB\_LIMITED | Preterido |
| DXGIX\_SWAP\_CHAIN\_FLAG\_COLORIMETRY\_sRGB\_TO\_REC709 | Preterido |
| DXGIX\_SWAP\_CHAIN\_MATCH\_OTHER\_CONSOLES | Preterido |
| DXGIX\_SWAP\_CHAIN\_MATCH\_XBOX360\_AND\_PC | Preterido |
| DXGIX\_SWAP\_CHAIN\_FLAG\_COLORIMETRY\_RGB\_BT2020\_ST2084 | Preterido |
| DXGIX\_SWAP\_CHAIN\_FLAG\_AUTOMATIC\_GAMEDVR\_TONEMAP | Preterido |

## Comentários

Essa enumeração é usada pela estrutura DXGI\_SWAP\_CHAIN\_DESC e pelo método IDXGISwapChain::ResizeTarget.

Essa enumeração também é usada pela estrutura DXGI\_SWAP\_CHAIN\_DESC1.

Você não precisa definir DXGI\_SWAP\_CHAIN\_FLAG\_DISPLAY\_ONLY para cadeias de troca criadas no modo de tela inteira com o método IDXGIFactory::CreateSwapChain, pois essas cadeias de troca já se comportam como se DXGI\_SWAP\_CHAIN\_FLAG\_DISPLAY\_ONLY estivesse definido. Ou seja, o conteúdo apresentado não fica acessível por acesso remoto nem por meio das APIs de duplicação da área de trabalho.

As cadeias de troca criadas com os métodos IDXGIFactory2::CreateSwapChainForHwnd, IDXGIFactory2::CreateSwapChainForCoreWindow e IDXGIFactory2::CreateSwapChainForComposition não são protegidas se DXGI\_SWAP\_CHAIN\_FLAG\_DISPLAY\_ONLY não estiver definido e são protegidas se DXGI\_SWAP\_CHAIN\_FLAG\_DISPLAY\_ONLY estiver definido. Quando as cadeias de troca são protegidas, a captura de tela é impedida e, no modo de tela inteira, o conteúdo apresentado não fica acessível por meio das APIs de duplicação da área de trabalho.

Ao chamar IDXGISwapChain::ResizeBuffers para alterar o buffer de fundo da cadeia de troca, você pode redefinir ou alterar todos os sinalizadores DXGI\_SWAP\_CHAIN\_FLAG.

## Requisitos

**Cabeçalho:** d3d12\_xs.h\
**Plataformas compatíveis**: consoles XBOX Series

## Confira também

[d3d12\_xs](/pt-BR/reference/graphics/d3d12_xs/d3d12_xs_members)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [DXGI_ADAPTER_DESC2 (XBOX Series consoles)](/reference/graphics/d3d12_xs/structs/dxgi_adapter_desc2.md)
- [D3D12_SHADER_CACHE_CONTROL_FLAGS (XBOX Series consoles)](/reference/graphics/d3d12/enums/d3d12_shader_cache_control_flags_public.md)
- [D3D12_EXPORT_FLAGS (XBOX Series consoles)](/reference/graphics/d3d12/enums/d3d12_export_flags_public.md)
