PFND3DDDI_RECLAIMRESOURCES回调函数 (d3dumddi.h)

项目
02/26/2024

由 Microsoft Direct3D 运行时调用，以回收以前提供以供重复使用的视频内存资源。

语法

PFND3DDDI_RECLAIMRESOURCES Pfnd3dddiReclaimresources;

HRESULT Pfnd3dddiReclaimresources(
  HANDLE hDevice,
  const D3DDDIARG_RECLAIMRESOURCES *unnamedParam2
)
{...}

参数

hDevice

显示设备的句柄 (图形上下文) 。

unnamedParam2

pData [in]

指向 D3DDDIARG_RECLAIMRESOURCES 结构的指针，该结构定义要回收的视频内存资源。

返回值

返回以下值之一：

返回代码	说明
S_OK	已成功回收视频内存资源。如果驱动程序不需要调用 pfnReclaimAllocationsCb 函数，则返回此错误代码。
E_INVALIDARG	提供了无效的参数。如果驱动程序调用 pfnReclaimAllocationsCb 函数，并且该函数返回E_INVALIDARG，则返回此错误代码。
D3DDDIERR_DEVICEREMOVED	视频内存管理器或显示微型端口驱动程序无法完成操作，因为发生了即插即用 (PnP) Stop 事件或超时检测和恢复 (TDR) 事件。如果驱动程序调用 pfnReclaimAllocationsCb 函数，并且该函数返回D3DDDIERR_DEVICEREMOVED，则返回此错误代码。注意：如果返回此错误代码，驱动程序的调用函数 (通常为 ReclaimResourcesDXGI 例程) 必须将此错误代码返回到 Direct3D 运行时。