PFND3DDDI_TEXBLT1回调函数 (d3dumddi.h)
执行从源纹理到目标纹理的位块传输 (bitblt) 操作,包括源纹理的所有子级别。 由 Windows 显示驱动程序模型 (WDDM) 1.2 或更高版本的用户模式显示驱动程序实现。
语法
PFND3DDDI_TEXBLT1 Pfnd3dddiTexblt1;
HRESULT Pfnd3dddiTexblt1(
HANDLE hDevice,
const D3DDDIARG_TEXBLT1 *unnamedParam2
)
{...}
参数
hDevice
显示设备的句柄 (图形上下文) 。
unnamedParam2
pData [in]
指向 D3DDDIARG_TEXBLT1 结构的指针,该结构定义纹理 bitblt 操作的参数。
返回值
如果未成功执行纹理 bitblt 操作,则返回S_OK或适当的错误结果。
注解
Microsoft Direct3D 运行时调用用户模式显示驱动程序的 TexBlt 函数,通知驱动程序执行从源纹理到目标纹理的 bitblt 操作。 纹理也可以是立方体环境贴图。 驱动程序应将源纹理中D3DDDIARG_TEXBLT结构的 SrcRect 成员指定的矩形复制到目标纹理中D3DDDIARG_TEXBLT的 DstPoint 成员指定的位置。 目标纹理和源纹理分别由D3DDDIARG_TEXBLT的 hDstResource 和 hSrcResource 句柄标识。
对于 MIP 映射纹理,驱动程序还必须复制源纹理中存在的所有 MIP 映射子级别。 源纹理和目标纹理可能包含不同数量的 MIP 映射级别。 在这种情况下,驱动程序应复制通用级别。 例如,如果 256x256 源纹理具有 8 个 MIP 贴图级别,并且目标为具有 6 个级别的 64x64 纹理,则驱动程序应从源复制六个相应的级别。 请注意,目标纹理的最高 MIP 级别的尺寸始终小于或等于源纹理的顶级 MIP 级别的尺寸。
源和目标句柄始终引用顶级图面,从不引用任何 MIP 映射子级别。
若要复制 MIP 贴图纹理的任意级别,运行时将改为调用驱动程序的 Blt 函数。
源纹理和目标纹理的像素格式相同,并且通常可以安全地执行指定的 bitblt 操作。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 |
最低受支持的服务器 | Windows Server 2012 |
目标平台 | 桌面 |
标头 | d3dumddi.h (包括 D3dumddi.h) |