PFND3DDDI_UNLOCK回调函数 (d3dumddi.h)
Unlock 函数解锁以前由 Lock 函数锁定的资源或资源中的图面。
语法
PFND3DDDI_UNLOCK Pfnd3dddiUnlock;
HRESULT Pfnd3dddiUnlock(
HANDLE hDevice,
const D3DDDIARG_UNLOCK *unnamedParam2
)
{...}
参数
hDevice
显示设备的句柄 (图形上下文) 。
unnamedParam2
pData [in]
指向 D3DDDIARG_UNLOCK 结构的指针，该结构描述要解锁的资源或图面。
返回值
解锁 返回以下值之一：
| 返回代码 | 说明 |
|---|---|
| S_OK | 资源已成功解锁。 |
| E_OUTOFMEMORY | 解锁无法分配完成所需的内存。 |
| E_INVALIDARG | 之前调用驱动程序的 Lock 函数时，D3DDDIARG_UNLOCK描述的资源未锁定。 |
注解
这些注释类似于 锁 参考页的“备注”部分中的说明。
调用 Unlock 后，用户模式显示驱动程序必须调用 Microsoft Direct3D 运行时的 pfnUnlockCb 函数。 在此 pfnUnlockCb 调用中，用户模式显示驱动程序会传递分配句柄。 在调用 pfnUnlockCb 之前，用户模式显示驱动程序必须先将图面映射到适当的分配。
运行时调用用户模式显示驱动程序的 Unlock 函数来解锁预分配的系统内存图面。 运行时在 pData 指向的 D3DDDIARG_UNLOCK 结构的 Flags 成员中设置 NotifyOnly 位字段标志，以区分解锁预分配的系统内存的解锁调用与其他解锁调用。 如果用户模式显示驱动程序的 Lock 函数称为 pfnLockCb 来锁定对应于图面的系统内存分配，则它还必须调用 pfnUnlockCb。 不调用 pfnUnlockCb 会停止运行时、用户模式显示驱动程序和显示微型端口驱动程序之间的协调。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Windows Vista 和更高版本的 Windows 操作系统中可用。 |
| 目标平台 | 通用 |
| 标头 | d3dumddi.h (包括 D3dumddi.h) |