Método IDXGISurface1::ReleaseDC (dxgi.h)

Libera el contexto del dispositivo GDI (DC) asociado a la superficie actual y permite usar Direct3D para representarlo.

Sintaxis

HRESULT ReleaseDC(
  [in, optional] RECT *pDirtyRect
);

Parámetros

[in, optional] pDirtyRect

Tipo: RECT*

Puntero a una estructura RECT que identifica la región sucia de la superficie.
Una región desfasada es cualquier parte de la superficie que usó para la representación de GDI y que desea conservar. Esta área se usa como sugerencia de rendimiento para el subsistema de gráficos en determinados escenarios. No use este parámetro para restringir la representación a la región rectangular especificada. Si pasa NULL, ReleaseDC considera toda la superficie como desfasada. De lo contrario, ReleaseDC usa el área especificada por el RECT como sugerencia de rendimiento para indicar qué áreas han sido manipuladas por la representación de GDI.

Puede pasar un puntero a una estructura RECT vacía (un rectángulo sin posición o área) si no cambió ningún contenido.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

DxGI 1.0 no admite este método, que se incluye en Windows Vista y Windows Server 2008. Se requiere compatibilidad con DXGI 1.1, que está disponible en Windows 7, Windows Server 2008 R2 y como actualización de Windows Vista con Service Pack 2 (SP2) (KB 971644) y Windows Server 2008 (KB 971512).

Use el método ReleaseDC para liberar el controlador de dominio e indicar que la aplicación finalizó toda la representación de GDI en esta superficie.
Debe llamar al método ReleaseDC para poder usar Direct3D para realizar una representación adicional.

Antes de cambiar el tamaño de los búferes, debe liberar todos los controladores de dominio pendientes.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	dxgi.h
Library	DXGI.lib

Consulte también

DXGI Interfaces

IDXGISurface1