Share via


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,以及以 Service Pack 2 (SP2) (KB) (KB 971644) 和 Windows Server 2008 (KB 971512) 更新。

使用 ReleaseDC 方法來釋放 DC,並指出您的應用程式已完成此介面的所有 GDI 轉譯。
您必須先呼叫 ReleaseDC 方法,才能使用 Direct3D 來執行其他轉譯。

在調整緩衝區大小之前,您必須釋放所有未處理的DC。

規格需求

需求
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 dxgi.h
程式庫 DXGI.lib

另請參閱

DXGI 介面

IDXGISurface1