Método IDXGIOutput1::GetDisplaySurfaceData1 (dxgi1_2.h)

Copia la superficie de presentación (búfer frontal) en un recurso proporcionado por el usuario.

Sintaxis

HRESULT GetDisplaySurfaceData1(
  [in] IDXGIResource *pDestination
);

Parámetros

[in] pDestination

Puntero a una interfaz de recursos que representa el recurso al que GetDisplaySurfaceData1 copia la superficie de visualización.

Valor devuelto

Devuelve uno de los códigos de error descritos en el tema DXGI_ERROR .

Comentarios

GetDisplaySurfaceData1 es similar a IDXGIOutput::GetDisplaySurfaceData excepto GetDisplaySurfaceData1 toma un IDXGIResource y IDXGIOutput::GetDisplaySurfaceData toma un IDXGISurface.

GetDisplaySurfaceData1 devuelve un error si el recurso de entrada no es una textura 2D (representada por la interfaz ID3D11Texture2D ) con un tamaño de matriz (miembro ArraySize de la estructura D3D11_TEXTURE2D_DESC ) que es igual a los búferes de la cadena de intercambio.

El IDXGIOutput::GetDisplaySurfaceData original y getDisplaySurfaceData1 actualizado se comportan exactamente igual. GetDisplaySurfaceData1 era necesario porque las texturas con un tamaño de matriz igual a 2 (ArraySize = 2) no implementan IDXGISurface.

Puede llamar a GetDisplaySurfaceData1 solo cuando una salida está en modo de pantalla completa. Si GetDisplaySurfaceData1 se realiza correctamente, rellena el recurso de destino.

Use IDXGIOutput::GetDesc para determinar el tamaño (ancho y alto) de la salida cuando desee asignar espacio para el recurso de destino. Esto es cierto independientemente de la rotación del monitor de destino. Se debe crear un recurso de destino creado por un componente de gráficos (como Direct3D 11) con el permiso de escritura de CPU (consulte D3D11_CPU_ACCESS_WRITE). Se pueden crear otras superficies con permiso de lectura y escritura de CPU (D3D11_CPU_ACCESS_READ D3D11_CPU_ACCESS_WRITE | ). GetDisplaySurfaceData1 modifica los datos de superficie para ajustarse al recurso de destino (stretch, shrink, convert format, rotate). GetDisplaySurfaceData1 realiza el ajuste y la reducción con muestreo de punto.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 y actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	dxgi1_2.h
Library	DXGI.lib

Consulte también

IDXGIOutput1