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) |