Compartilhar via


estrutura DXGI_SWAP_CHAIN_DESC (dxgi.h)

Descreve uma cadeia de troca.

Sintaxe

typedef struct DXGI_SWAP_CHAIN_DESC {
  DXGI_MODE_DESC   BufferDesc;
  DXGI_SAMPLE_DESC SampleDesc;
  DXGI_USAGE       BufferUsage;
  UINT             BufferCount;
  HWND             OutputWindow;
  BOOL             Windowed;
  DXGI_SWAP_EFFECT SwapEffect;
  UINT             Flags;
} DXGI_SWAP_CHAIN_DESC;

Membros

BufferDesc

Tipo: DXGI_MODE_DESC

Uma estrutura DXGI_MODE_DESC que descreve o modo de exibição backbuffer.

SampleDesc

Tipo: DXGI_SAMPLE_DESC

Uma estrutura DXGI_SAMPLE_DESC que descreve parâmetros de várias amostras.

BufferUsage

Tipo: DXGI_USAGE

Um membro do DXGI_USAGE tipo enumerado que descreve o uso da superfície e as opções de acesso à CPU para o buffer de fundo. O buffer de fundo pode ser usado para entrada de sombreador ou saída de destino de renderização.

BufferCount

Tipo: UINT

Um valor que descreve o número de buffers na cadeia de troca. Quando você chama IDXGIFactory::CreateSwapChain para criar uma cadeia de troca de tela inteira, normalmente você inclui o buffer frontal nesse valor. Para obter mais informações sobre buffers de cadeia de troca, consulte Comentários.

OutputWindow

Tipo: HWND

Um identificador HWND para a janela de saída. Esse membro não deve ser NULL.

Windowed

Tipo: BOOL

Um valor booliano que especifica se a saída está no modo de janela. TRUE se a saída estiver no modo de janela; caso contrário, FALSE.

Recomendamos que você crie uma cadeia de troca em janelas e permita que o usuário final altere a cadeia de troca para tela inteira por meio de IDXGISwapChain::SetFullscreenState; ou seja, não defina esse membro como FALSE para forçar a cadeia de troca a ser de tela inteira. No entanto, se você criar a cadeia de troca como tela inteira, também forneça ao usuário final uma lista de modos de exibição com suporte por meio do membro BufferDesc porque uma cadeia de troca criada com um modo de exibição sem suporte pode fazer com que a exibição fique preta e impedir que o usuário final veja qualquer coisa.

Para obter mais informações sobre como escolher versos em janelas em tela inteira, consulte IDXGIFactory::CreateSwapChain.

SwapEffect

Tipo: DXGI_SWAP_EFFECT

Um membro do DXGI_SWAP_EFFECT tipo enumerado que descreve as opções para lidar com o conteúdo do buffer de apresentação depois de apresentar uma superfície.

Flags

Tipo: UINT

Um membro do DXGI_SWAP_CHAIN_FLAG tipo enumerado que descreve as opções para o comportamento da cadeia de troca.

Comentários

Essa estrutura é usada pelos métodos GetDesc e CreateSwapChain .

No modo de tela inteira, há um buffer frontal dedicado; no modo de janela, a área de trabalho é o buffer frontal.

Se você criar uma cadeia de troca com um buffer, especificar DXGI_SWAP_EFFECT_SEQUENTIAL não fará com que o conteúdo do buffer único seja trocado pelo buffer frontal.

Para obter informações de desempenho sobre como inverter buffers de cadeia de troca no aplicativo de tela inteira, consulte Dicas de desempenho de aplicativo de tela inteira.

Requisitos

   
Cabeçalho dxgi.h

Confira também

Estruturas DXGI

IDXGIFactory::CreateSwapChain

IDXGISwapChain