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

  • Artículo

[A partir de Direct3D 11.1, se recomienda no usar GetDisplaySurfaceData para recuperar la superficie de visualización actual. En su lugar, use IDXGIOutput1::GetDisplaySurfaceData1, que admite el modo de visualización estéreo.]

Obtiene una copia de la superficie de visualización actual.

Sintaxis

HRESULT GetDisplaySurfaceData(
  [in] IDXGISurface *pDestination
);

Parámetros

[in] pDestination

Tipo: IDXGISurface*

Puntero a una superficie de destino (consulte IDXGISurface).

Valor devuelto

Tipo: HRESULT

Devuelve uno de los valores de DXGI_ERROR .

Comentarios

IDXGIOutput::GetDisplaySurfaceData solo se puede llamar cuando una salida está en modo de pantalla completa. Si el método se realiza correctamente, DXGI rellena la superficie de destino.

Use IDXGIOutput::GetDesc para determinar el tamaño (ancho y alto) de la salida cuando desee asignar espacio para la superficie de destino. Esto es cierto independientemente de la rotación del monitor de destino. Se debe crear una superficie de destino creada por un componente de gráficos (como Direct3D 10) con el permiso de escritura de CPU (consulte D3D10_CPU_ACCESS_WRITE). Se deben crear otras superficies con el permiso de lectura y escritura de CPU (consulte D3D10_CPU_ACCESS_READ_WRITE). Este método modificará los datos de superficie para ajustarse a la superficie de destino (estirar, reducir, convertir formato, girar). El ajuste y la reducción se realizan con muestreo de punto.

Requisitos

   
Plataforma de destino Windows
Encabezado dxgi.h
Library DXGI.lib

Consulte también

DXGI Interfaces

IDXGIOutput