Método IDXGIOutput::GetDisplaySurfaceData (dxgi.h)
[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 |