PDD_DESTROYDDLOCAL回呼函式 (ddrawint.h)

發行項
02/26/2024

D3dDestroyDDLocal 函式會終結先前由 D3dCreateSurfaceEx 函式所建立的所有 Microsoft Direct3D 表面，該函式屬於相同指定的本機 Microsoft DirectDraw 物件。

語法

PDD_DESTROYDDLOCAL PddDestroyddlocal;

DWORD PddDestroyddlocal(
  PDD_DESTROYDDLOCALDATA unnamedParam1
)
{...}

參數

unnamedParam1

指向 DDHAL_DESTROYDDLOCALDATA 結構，其中包含驅動程序終結表面所需的資訊。

傳回值

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

備註

所有 Direct3D 驅動程式都必須支援 D3dDestroyDDLocal。

當應用程式指出不再需要 Direct3D 內容時， Direct3D 會呼叫 D3dDestroyDDLocal ，而且將會與它相關聯的所有表面一起終結。關聯會透過本機 DirectDraw 物件的指標。驅動程式必須視需要釋放驅動程式的 D3dCreateSurfaceEx 回呼配置給每個表面的任何記憶體。

驅動程式不應該終結與這些 Direct3D 表面相關聯的 DirectDraw 表面。這是應用程式的責任。

在 D3dDestroyDDDLocal 傳回之後，當呼叫 D3dContextCreate 時，D3DHAL_CONTEXTCREATEDATA 結構的 lpDDLcl 成員傳入DD_DIRECTDRAW_LOCAL結構的指標。

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