Метод IDXGISurface1::ReleaseDC (dxgi.h)

Освобождает контекст устройства GDI (DC), связанный с текущей поверхностью, и позволяет использовать Direct3D для отрисовки.

Синтаксис

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

Параметры

[in, optional] pDirtyRect

Тип: RECT*

Указатель на структуру RECT, которая определяет грязное области поверхности.
Область грязное — это любая часть поверхности, которая использовалась для отрисовки GDI и которую требуется сохранить. Эта область используется в качестве указания производительности для графической подсистемы в определенных сценариях. Не используйте этот параметр, чтобы ограничить отрисовку указанной прямоугольной областью. Если вы передаете значение NULL, ReleaseDC считает всю поверхность грязное. В противном случае ReleaseDC использует область, указанную в RECT, в качестве указания производительности, чтобы указать, какие области были изменены при отрисовке GDI.

Если вы не изменили содержимое, вы можете передать указатель на пустую структуру RECT (прямоугольник без положения или области).

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод не поддерживается DXGI 1.0, который поставляется в Windows Vista и Windows Server 2008. Требуется поддержка DXGI 1.1, которая доступна в Windows 7, Windows Server 2008 R2, а также в качестве обновления для Windows Vista с пакетом обновления 2 (SP2) (971644 базы знаний) и Windows Server 2008 (971512 базы знаний).

Используйте метод ReleaseDC , чтобы освободить контроллер домена и указать, что приложение завершило всю отрисовку GDI на этой поверхности.
Прежде чем использовать Direct3D для выполнения дополнительной отрисовки, необходимо вызвать метод ReleaseDC .

Перед изменением размера буферов необходимо освободить все необработанные контроллеры домена.

Требования

См. также раздел

Интерфейсы DXGI

IDXGISurface1