PFND3DDDI_RENAME回调函数 (d3dumddi.h)

Rename 函数通知用户模式显示驱动程序开始使用以前为指定资源返回的 LockAsync 函数的重命名分配。

语法

PFND3DDDI_RENAME Pfnd3dddiRename;

HRESULT Pfnd3dddiRename(
  HANDLE hDevice,
  const D3DDDIARG_RENAME *unnamedParam2
)
{...}

参数

hDevice

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

unnamedParam2

pData [in]

指向 D3DDDIARG_RENAME 结构的指针,该结构描述资源或图面,以使用新分配进行重命名。

返回值

重命名 返回以下值之一:

返回代码 说明
S_OK 已成功重命名资源。
E_OUTOFMEMORY 重命名无法为其分配所需的内存才能完成。

备注

在多处理器计算机上,Microsoft Direct3D 运行时从工作线程而不是主应用程序线程调用用户模式显示驱动程序的 Rename 函数。 运行时最多调用一次“重命名”,每次成功调用驱动程序的 LockAsync 函数时,都会调用一次,并在 LockAsync 参数的 pData 参数指向D3DDDIARG_LOCKASYNC结构的 Flags 成员中设置“放弃位字段”标志。

重命名会通知驱动程序开始使用由D3DDDIARG_RENAME结构的 hCookie 成员指定的重命名分配,重命名pData 参数指向该分配。 如果为锁定的资源设置了“放弃位字段”标志,则 LockAsync 函数以前返回 hCookie 句柄。

重命名成功 (S_OK) 后,用户模式显示驱动程序应使用 hCookie 为引用D3DDDIARG_RENAME D3DDDIARG_RENAME的 hResourceSubResourceIndex 成员所引用的资源的所有呈现操作指定的分配。

要求

   
最低受支持的客户端 在 Windows Vista 及更高版本的 Windows 操作系统中可用。
目标平台 通用
标头 d3dumddi.h (包括 D3dumddi.h)

另请参阅

D3DDDIARG_LOCKASYNC

D3DDDIARG_RENAME

D3DDDI_DEVICEFUNCS

LockAsync

重命名