Método IDXGIOutput1::GetDisplaySurfaceData1 (dxgi1_2.h)
Copia a superfície de exibição (buffer frontal) para um recurso fornecido pelo usuário.
Sintaxe
HRESULT GetDisplaySurfaceData1(
[in] IDXGIResource *pDestination
);
Parâmetros
[in] pDestination
Um ponteiro para uma interface de recurso que representa o recurso para o qual GetDisplaySurfaceData1 copia a superfície de exibição.
Retornar valor
Retorna um dos códigos de erro descritos no tópico DXGI_ERROR .
Comentários
GetDisplaySurfaceData1 é semelhante a IDXGIOutput::GetDisplaySurfaceData , exceto que GetDisplaySurfaceData1 usa um IDXGIResource e IDXGIOutput::GetDisplaySurfaceData usa um IDXGISurface.
GetDisplaySurfaceData1 retornará um erro se o recurso de entrada não for uma textura 2D (representada pela interface ID3D11Texture2D ) com um tamanho de matriz (membro ArraySize da estrutura D3D11_TEXTURE2D_DESC ) igual aos buffers de cadeia de troca.
O IDXGIOutput::GetDisplaySurfaceData original e o GetDisplaySurfaceData1 atualizados se comportam exatamente da mesma forma. GetDisplaySurfaceData1 foi necessário porque texturas com um tamanho de matriz igual a 2 (ArraySize = 2) não implementam IDXGISurface.
Você pode chamar GetDisplaySurfaceData1 somente quando uma saída estiver no modo de tela inteira. Se GetDisplaySurfaceData1 for bem-sucedido, ele preencherá o recurso de destino.
Use IDXGIOutput::GetDesc para determinar o tamanho (largura e altura) da saída quando quiser alocar espaço para o recurso de destino. Isso é verdadeiro, independentemente da rotação do monitor de destino. Um recurso de destino criado por um componente gráfico (como Direct3D 11) deve ser criado com a permissão de gravação da CPU (consulte D3D11_CPU_ACCESS_WRITE). Outras superfícies podem ser criadas com permissão de leitura/gravação da CPU (D3D11_CPU_ACCESS_READ | D3D11_CPU_ACCESS_WRITE). GetDisplaySurfaceData1 modifica os dados da superfície para se ajustarem ao recurso de destino (alongar, reduzir, converter formato, girar). GetDisplaySurfaceData1 executa o alongamento e a redução com amostragem de ponto.
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] |
| Plataforma de Destino | Windows |
| Cabeçalho | dxgi1_2.h |
| Biblioteca | DXGI.lib |