Método IDXGISwapChain::ResizeTarget (dxgi.h)

  • Artigo

Redimensiona o destino de saída.

Sintaxe

HRESULT ResizeTarget(
  [in] const DXGI_MODE_DESC *pNewTargetParameters
);

Parâmetros

[in] pNewTargetParameters

Tipo: const DXGI_MODE_DESC*

Um ponteiro para uma estrutura DXGI_MODE_DESC que descreve o modo , que especifica a nova largura, altura, formato e taxa de atualização do destino. Se o formato for DXGI_FORMAT_UNKNOWN, ResizeTarget usará o formato existente. Só recomendamos que você use DXGI_FORMAT_UNKNOWN quando a cadeia de troca estiver no modo de tela inteira, pois esse método não é thread-safe.

Retornar valor

Tipo: HRESULT

Retorna um código que indica êxito ou falha. DXGI_STATUS_MODE_CHANGE_IN_PROGRESS será retornado se uma transição de modo de tela inteira/janela estiver ocorrendo quando essa API for chamada. Consulte DXGI_ERROR para obter códigos de erro DXGI adicionais.

Comentários

ResizeTarget redimensiona a janela de destino quando a cadeia de troca está no modo de janela e altera o modo de exibição na saída de destino quando a cadeia de troca está no modo de tela inteira. Portanto, os aplicativos podem chamar ResizeTarget para redimensionar a janela de destino (em vez de um Microsoft Win32API, como SetWindowPos) sem conhecimento do modo de exibição de cadeia de troca.

Se um aplicativo da Windows Store chamar ResizeTarget, ele falhará com DXGI_ERROR_NOT_CURRENTLY_AVAILABLE.

Você não pode chamar ResizeTarget em uma cadeia de troca criada com IDXGIFactory2::CreateSwapChainForComposition.

Os aplicativos ainda devem chamar IDXGISwapChain::ResizeBuffers depois de chamar ResizeTarget porque somente ResizeBuffers pode alterar os buffers de fundo. Mas, se esses aplicativos implementaram o processamento de redimensionamento de janela para chamar o ResizeBuffers, eles não precisarão chamar explicitamente ResizeBuffers depois de chamarEm ResizeTarget porque o processamento de redimensionamento da janela alcançará o que o aplicativo requer.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho dxgi.h
Biblioteca DXGI.lib

Confira também

IDXGISwapChain