NtGdiDdDestroySurface 函式
[此函式可能會隨著每個作業系統修訂而變更。 請改用 DirectDraw 和 Microsoft Direct3DAPIs;這些 API 會隔離應用程式與這類作業系統變更，並隱藏與顯示驅動程式直接互動所涉及的許多其他困難。
終結先前配置的核心模式 Microsoft DirectDraw 介面物件。
語法
DWORD APIENTRY NtGdiDdDestroySurface(
_In_ HANDLE hSurface,
_In_ BOOL bRealDestroy
);
參數
-
hSurface [in]
-
處理先前配置的核心模式介面物件。
-
bRealDestroy [in]
-
指定如何終結表面。 可以是下列其中一個值。
-
(TRUE)
-
終結表面並釋放視訊記憶體。
-
(FALSE)
-
釋放視訊記憶體，但讓表面保持未初始化的狀態。
傳回值
NtGdiDdDestroySurface 會傳回下列其中一個回呼代碼。
| 傳回碼 | Description |
|---|---|
|
驅動程式已執行作業，並傳回該作業的有效傳回碼。 如果此程式碼DD_OK，DirectDraw 或 Direct3D 會繼續進行 函式。 否則，DirectDraw 或 Direct3D 會傳回驅動程式所提供的錯誤碼，並中止函式。 |
|
驅動程式對於要求的作業沒有批註。 如果需要驅動程式實作特定的回呼，DirectDraw 或 Direct3D 會報告錯誤狀況。 否則，DirectDraw 或 Direct3D 會處理作業，就像驅動程式回呼尚未藉由執行 DirectDraw 或 Direct3D 裝置獨立實作來定義。 |
備註
建議應用程式使用 DirectDraw 和 Direct3D API 來建立和終結表面，而不是此函式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限桌面應用程式] |
| 標頭 |
|
另請參閱