Método IDXGISurface1::ReleaseDC (dxgi.h)
Libera o DC (contexto do dispositivo GDI) associado à superfície atual e permite que você use o Direct3D para renderizar.
Sintaxe
HRESULT ReleaseDC(
[in, optional] RECT *pDirtyRect
);
Parâmetros
[in, optional] pDirtyRect
Tipo: RECT*
Um ponteiro para uma estrutura RECT que identifica a sujo região da superfície.
Uma região sujo é qualquer parte da superfície que você usou para renderização GDI e que você deseja preservar.
Essa área é usada como uma dica de desempenho para o subsistema gráfico em determinados cenários.
Não use esse parâmetro para restringir a renderização para a região retangular especificada.
Se você passar NULL, ReleaseDC considerará toda a superfície como sujo.
Caso contrário, o ReleaseDC usa a área especificada pelo RECT como uma dica de desempenho para indicar quais áreas foram manipuladas pela renderização GDI.
Você pode passar um ponteiro para uma estrutura RECT vazia (um retângulo sem posição ou área) se não tiver alterado nenhum conteúdo.
Retornar valor
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Esse método não tem suporte do DXGI 1.0, que foi enviado no Windows Vista e no Windows Server 2008. O suporte ao DXGI 1.1 é necessário, que está disponível no Windows 7, Windows Server 2008 R2 e como uma atualização para o Windows Vista com Service Pack 2 (SP2) (KB 971644) e Windows Server 2008 (KB 971512).
Use o método ReleaseDC para liberar o DC e indicar que o aplicativo terminou toda a renderização GDI para essa superfície.
Você deve chamar o método ReleaseDC antes de usar o Direct3D para executar renderização adicional.
Antes de redimensionar buffers, você deve liberar todos os DCs pendentes.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | dxgi.h |
| Biblioteca | DXGI.lib |