Método IDXGIOutput::GetDisplaySurfaceData (dxgi.h)

  • Artigo

[A partir do Direct3D 11.1, recomendamos não usar mais GetDisplaySurfaceData para recuperar a superfície de exibição atual. Em vez disso, use IDXGIOutput1::GetDisplaySurfaceData1, que dá suporte ao modo de exibição estéreo.]

Obtém uma cópia da superfície de exibição atual.

Sintaxe

HRESULT GetDisplaySurfaceData(
  [in] IDXGISurface *pDestination
);

Parâmetros

[in] pDestination

Tipo: IDXGISurface*

Um ponteiro para uma superfície de destino (consulte IDXGISurface).

Valor retornado

Tipo: HRESULT

Retorna um dos valores DXGI_ERROR .

Comentários

IDXGIOutput::GetDisplaySurfaceData só pode ser chamado quando uma saída está no modo de tela inteira. Se o método for bem-sucedido, o DXGI preencherá a superfície de destino.

Use IDXGIOutput::GetDesc para determinar o tamanho (largura e altura) da saída quando quiser alocar espaço para a superfície de destino. Isso é verdadeiro, independentemente da rotação do monitor de destino. Uma superfície de destino criada por um componente gráfico (como Direct3D 10) deve ser criada com permissão de gravação de CPU (consulte D3D10_CPU_ACCESS_WRITE). Outras superfícies devem ser criadas com permissão de leitura/gravação da CPU (consulte D3D10_CPU_ACCESS_READ_WRITE). Esse método modificará os dados da superfície para se ajustarem à superfície de destino (alongar, reduzir, converter formato, girar). O alongamento e a redução são executados com amostragem de ponto.

Requisitos

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

Confira também

DXGI Interfaces

IDXGIOutput