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 運行時間會從背景工作線程呼叫使用者模式顯示驅動程式的 Rename 函式，而不是從主要應用程式線程呼叫。 運行時間最多會針對驅動程式的 LockAsync 函式呼叫 Rename 一次，並在 LockAsync參數的 pData 參數所指向之 D3DDDIARG_LOCKASYNC 結構的 Flags 成員中設定 Discard 位字段旗標。
重新命名會通知驅動程序開始使用由 D3DDDIARG_RENAME 結構 hCookie 成員所指定的重新命名配置，而重新命名為 Rename 的 pData 參數所指向。 如果為鎖定的資源設定了 Discard 位欄位旗標，則 LockAsync 函式先前會傳回 hCookie 句柄。
使用 S_OK) 成功 (Rename 傳回之後，使用者模式顯示驅動程式應該使用 hCookie 針對參考D3DDDIARG_RENAME指定之 hResource 和 SubResourceIndex 成員資源的所有轉譯作業所指定的配置。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
| 目標平台 | Universal |
| 標頭 | d3dumddi.h (包含 D3dumddi.h) |