PFND3DDDI_OFFERALLOCATIONSCB回调函数 (d3dumddi.h)

项目
02/23/2024

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

语法

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	提供了无效的参数。