PFND3DDDI_RENAME回调函数 (d3dumddi.h)

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

语法

PFND3DDDI_RENAME Pfnd3dddiRename;

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

参数

hDevice

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

unnamedParam2

pData [in]

指向 D3DDDIARG_RENAME 结构的指针，该结构描述资源或要用新分配重命名的资源或图面。

返回值

Rename 返回以下值之一：

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

注解

在多处理器计算机上，Microsoft Direct3D 运行时从工作线程而不是从main应用程序线程调用用户模式显示驱动程序的 Rename 函数。 对于每次成功调用驱动程序的 LockAsync 函数，运行时最多调用一次 Rename，并在 LockAsync 的 pData 参数指向的 D3DDDIARG_LOCKASYNC 结构的 Flags 成员中设置 Discard 位字段标志。

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

在 Rename 使用 S_OK) 成功返回 (后，用户模式显示驱动程序应使用 hCookie 为引用D3DDDIARG_RENAME的 hResource 和 SubResourceIndex 成员指定的资源的所有呈现操作指定的分配。

要求

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

另请参阅

D3DDDIARG_LOCKASYNC

D3DDDIARG_RENAME

D3DDDI_DEVICEFUNCS

LockAsync

重命名