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 .

Nota Não é possível converter um DXGI_SWAP_CHAIN_DESC1 em um DXGI_SWAP_CHAIN_DESC e vice-versa. Um aplicativo deve usar explicitamente o método IDXGISwapChain1::GetDesc1 para recuperar a versão mais recente da estrutura de descrição da cadeia de troca.
 
No modo de tela inteira, há um buffer frontal dedicado; no modo de janela, a área de trabalho é o buffer frontal.

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

Confira também

Estruturas DXGI

IDXGISwapChain1::GetDesc1