PFND3DDDI_OFFERALLOCATIONSCB回调函数 (d3dumddi.h)

由用户模式显示驱动程序调用,提供视频内存分配供重复使用。

语法

PFND3DDDI_OFFERALLOCATIONSCB Pfnd3dddiOfferallocationscb;

HRESULT Pfnd3dddiOfferallocationscb(
  HANDLE hDevice,
  const D3DDDICB_OFFERALLOCATIONS *unnamedParam2
)
{...}

参数

hDevice

显示设备的句柄 (图形上下文) 。 Direct3D 运行时在设备创建时将用户模式驱动程序此句柄作为 D3DDDIARG_CREATEDEVICE 结构的 hDevice 成员传递。

unnamedParam2

pData [in]

一个指针 D3DDDICB_OFFERALLOCATIONS 定义驱动程序提供的视频内存分配的结构。

返回值

返回以下值之一。

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

注解

用户模式显示驱动程序调用 pfnOfferAllocationsCb 来通知 Microsoft DirectX 图形内核子系统,完成以前提交的任何呈现操作后,它可以为其他进程提供分配的内存。

驱动程序调用 pfnOfferAllocationsCb 提供要重用的分配后,必须先调用 pfnReclaimAllocationsCb ,然后才能锁定分配或提交分配以执行呈现操作。

要求

   
最低受支持的客户端 Windows 8
最低受支持的服务器 Windows Server 2012
目标平台 桌面型
标头 d3dumddi.h (包括 D3dumddi.h)

请参阅

D3DDDIARG_CREATEDEVICE

D3DDDICB_OFFERALLOCATIONS

D3DDDI_DEVICECALLBACKS

pfnOfferResources

pfnReclaimAllocationsCb