PDD_SURFCB_DESTROYSURFACE ddrawint.h (回呼函式)

發行項
08/23/2023

DdDestroySurface回呼函式會終結 DirectDraw 表面。

語法

PDD_SURFCB_DESTROYSURFACE PddSurfcbDestroysurface;

DWORD PddSurfcbDestroysurface(
  PDD_DESTROYSURFACEDATA unnamedParam1
)
{...}

參數

unnamedParam1

指向包含終結表面所需資訊的 DD_DESTROYSURFACEDATA 結構。

傳回值

DdDestroySurface 會傳回下列其中一個回呼代碼：

備註

如果 DirectDraw 在介面建立時執行記憶體配置，且驅動程式未涉及配置，DirectDraw 不會呼叫驅動程式的 DdDestroySurface 函式來終結表面。

如果驅動程式正在執行表面記憶體管理本身，DdDestroySurface應該釋放表面記憶體並執行任何其他清除，例如釋放儲存在DD_SURFACE_GLOBAL和DD_SURFACE_LOCAL結構之dwReserved1成員中的私用資料。

對於驅動程式管理的介面，如果表面是持續性 (，則不會設定表面DDSCAPS2結構之 dwCaps2成員中的DDSCAPS2_DONOTPERSIST旗標，) 設定DdDestroySurface，即可呼叫 DdDestroySurface，以便從視訊記憶體收回表面。在此情況下，顯示驅動程式可以繼續保留 dwReserved1 成員中的任何私人資料，直到 呼叫 DdDestroySurface 以實際終結表面為止。

您可以使用停用的 PDEV呼叫DdDestroySurface。 PDEV 已停用或啟用，方法是呼叫顯示器驅動程式的 DrvAssertMode 函式。如需詳細資訊，請參閱管理 PDEV 。