Metodo IDXGISurface1::ReleaseDC (dxgi.h)

Rilascia il contesto del dispositivo GDI (DC) associato alla superficie corrente e consente di usare Direct3D per eseguire il rendering.

Sintassi

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

Parametri

[in, optional] pDirtyRect

Tipo: RECT*

Puntatore a una struttura RECT che identifica l'area sporca della superficie.
Un'area sporca è una parte della superficie usata per il rendering GDI e che si vuole conservare. Questa area viene usata come hint per le prestazioni per il sottosistema grafico in determinati scenari. Non usare questo parametro per limitare il rendering all'area rettangolare specificata. Se si passa NULL, ReleaseDC considera l'intera superficie come sporca. In caso contrario, ReleaseDC usa l'area specificata da RECT come hint per le prestazioni per indicare quali aree sono state modificate dal rendering GDI.

È possibile passare un puntatore a una struttura RECT vuota (un rettangolo senza posizione o area) se non è stato modificato alcun contenuto.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo non è supportato da DXGI 1.0, fornito in Windows Vista e Windows Server 2008. Il supporto di DXGI 1.1 è necessario, disponibile in Windows 7, Windows Server 2008 R2 e come aggiornamento a Windows Vista con Service Pack 2 (SP2) (KB 971644) e Windows Server 2008 (KB 971512).

Usare il metodo ReleaseDC per rilasciare il controller di dominio e indicare che l'applicazione ha completato tutto il rendering GDI in questa superficie.
È necessario chiamare il metodo ReleaseDC prima di poter usare Direct3D per eseguire il rendering aggiuntivo.

Prima di ridimensionare i buffer, è necessario rilasciare tutti i controller di dominio in sospeso.

Requisiti

Vedi anche

Interfacce DXGI

IDXGISurface1