PDD_DESTROYDDLOCAL回调函数 (ddrawint.h)

项目
02/26/2024

D3dDestroyDDLocal 函数销毁以前由属于同一给定本地 Microsoft DirectDraw 对象的 D3dCreateSurfaceEx 函数创建的所有 Microsoft Direct3D 图面。

语法

PDD_DESTROYDDLOCAL PddDestroyddlocal;

DWORD PddDestroyddlocal(
  PDD_DESTROYDDLOCALDATA unnamedParam1
)
{...}

参数

unnamedParam1

指向 DDHAL_DESTROYDDLOCALDATA 结构，该结构包含驱动程序销毁图面所需的信息。

返回值

D3dDestroyDDLocal 返回以下回调代码之一：

注解

所有 Direct3D 驱动程序都必须支持 D3dDestroyDDLocal。

当应用程序指示不再需要 Direct3D 上下文时，Direct3D 会调用 D3dDestroyDDLocal ，并且该上下文将与与其关联的所有图面一起销毁。关联通过指向本地 DirectDraw 对象的指针实现。如有必要，驱动程序必须释放驱动程序的 D3dCreateSurfaceEx 回调为每个图面分配的任何内存。

驱动程序不应销毁与这些 Direct3D 图面关联的 DirectDraw 图面。这是应用程序的责任。

指向在调用 D3dContextCreate 时作为 D3DHAL_CONTEXTCREATEDATA 结构的 lpDDLcl 成员传入的 DD_DIRECTDRAW_LOCAL 结构的指针在 D3dDestroyDDLocal 返回后由操作系统释放。

可以使用禁用的 PDEV 调用 D3dDestroyDDLocal。通过调用显示驱动程序的 DrvAssertMode 函数禁用或启用 PDEV。有关详细信息，请参阅管理 PDEV 。