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

Confira também

IDXGIOutput1