estrutura DXGI_SWAP_CHAIN_DESC1 (dxgi1_2.h)
Descreve uma cadeia de troca.
Sintaxe
typedef struct DXGI_SWAP_CHAIN_DESC1 {
UINT Width;
UINT Height;
DXGI_FORMAT Format;
BOOL Stereo;
DXGI_SAMPLE_DESC SampleDesc;
DXGI_USAGE BufferUsage;
UINT BufferCount;
DXGI_SCALING Scaling;
DXGI_SWAP_EFFECT SwapEffect;
DXGI_ALPHA_MODE AlphaMode;
UINT Flags;
} DXGI_SWAP_CHAIN_DESC1;
Membros
Width
Um valor que descreve a largura da resolução. Se você especificar a largura como zero ao chamar o método IDXGIFactory2::CreateSwapChainForHwnd para criar uma cadeia de troca, o runtime obterá a largura da janela de saída e atribuirá esse valor de largura à descrição da cadeia de troca. Posteriormente, você pode chamar o método IDXGISwapChain1::GetDesc1 para recuperar o valor de largura atribuído. Você não pode especificar a largura como zero ao chamar o método IDXGIFactory2::CreateSwapChainForComposition .
Height
Um valor que descreve a altura da resolução. Se você especificar a altura como zero ao chamar o método IDXGIFactory2::CreateSwapChainForHwnd para criar uma cadeia de troca, o runtime obterá a altura da janela de saída e atribuirá esse valor de altura à descrição da cadeia de troca. Posteriormente, você pode chamar o método IDXGISwapChain1::GetDesc1 para recuperar o valor de altura atribuído. Você não pode especificar a altura como zero ao chamar o método IDXGIFactory2::CreateSwapChainForComposition .
Format
Uma estrutura DXGI_FORMAT que descreve o formato de exibição.
Stereo
Especifica se o modo de exibição de tela inteira ou o buffer traseiro de cadeia de troca é estéreo. TRUE se estéreo; caso contrário, FALSE. Se você especificar estéreo, também deverá especificar uma cadeia de troca de modelo de inversão (ou seja, uma cadeia de troca que tenha o valor DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL definido no membro SwapEffect ).
SampleDesc
Uma estrutura DXGI_SAMPLE_DESC que descreve parâmetros de várias amostras. Esse membro é válido apenas com cadeias de troca de modelo de transferência de bloco de bits (bitblt).
BufferUsage
Um valor do tipo DXGI_USAGE que descreve o uso da superfície e as opções de acesso à CPU para o buffer traseiro. O buffer traseiro pode ser usado para entrada de sombreador ou saída de destino de renderização.
BufferCount
Um valor que descreve o número de buffers na cadeia de troca. Ao criar uma cadeia de troca de tela inteira, normalmente você inclui o buffer frontal nesse valor.
Scaling
Um valor de tipo DXGI_SCALING que identifica o comportamento de redimensionamento se o tamanho do buffer traseiro não for igual à saída de destino.
SwapEffect
Um valor de tipo DXGI_SWAP_EFFECT que descreve o modelo de apresentação usado pela cadeia de troca e as opções para lidar com o conteúdo do buffer de apresentação depois de apresentar uma superfície. Você deve especificar o valor DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL ao chamar o método IDXGIFactory2::CreateSwapChainForComposition porque esse método dá suporte apenas ao modelo de apresentação flip.
AlphaMode
Um valor de tipo DXGI_ALPHA_MODE que identifica o comportamento de transparência do buffer de back da cadeia de troca.
Flags
Uma combinação de valores de tipo DXGI_SWAP_CHAIN_FLAG que são combinados usando uma operação OR bit a bit. O valor resultante especifica opções para o comportamento da cadeia de troca.
Comentários
Essa estrutura é usada pelos métodos CreateSwapChainForHwnd, CreateSwapChainForCoreWindow, CreateSwapChainForComposition, CreateSwapChainForCompositionSurfaceHandle e GetDesc1 .
Para uma cadeia de troca de modelo de inversão (ou seja, uma cadeia de troca que tem o valor DXGI_SWAP_EFFECT_FLIP_DISCARD ou DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL definido no membro SwapEffect ), você deve definir o membro Format como DXGI_FORMAT_R16G16B16A16_FLOAT, DXGI_FORMAT_B8G8R8A8_UNORM, DXGI_FORMAT_R8G8B8A8_UNORM ou DXGI_FORMAT_R10G10B10A10_UNORM; você deve definir o membro Count da estrutura DXGI_SAMPLE_DESC que o membro SampleDesc especifica como um e o membro Quality de DXGI_SAMPLE_DESC como zero porque não há suporte para várias análulações de exemplo (MSAA) ; você deve definir o membro BufferCount como de dois a dezesseis. Para obter mais informações sobre a cadeia de troca de modelo flip, consulte DXGI Flip Model.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 e Atualização de Plataforma para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2012 e Atualização de Plataforma para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
| Cabeçalho | dxgi1_2.h |