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 结构的指针,用于定义纹理位运算的参数。

返回值

如果未成功执行纹理位运算,则返回S_OK或适当的错误结果。

言论

Microsoft Direct3D 运行时调用用户模式显示驱动程序的 TexBlt 函数,以通知驱动程序从源纹理到目标纹理执行位运算。 纹理也可以是立方环境图。 驱动程序应将源纹理中 D3DDDIARG_TEXBLT 结构的 SrcRect 成员指定的矩形复制到目标纹理中 DstPoint D3DDDIARG_TEXBLT成员指定的位置。 目标纹理和源纹理由 hDstResourcehSrcResource 句柄分别标识D3DDDIARG_TEXBLT。

对于 MIP 映射的纹理,驱动程序还必须复制源纹理中存在的所有 MIP 映射子层。 源纹理和目标纹理可能包含不同的 MIP 映射级别数。 在这种情况下,驱动程序应复制通用级别。 例如,如果 256x256 源纹理具有 8 个 MIP 地图级别,并且目标为具有 64x64 的纹理,则驱动程序应从源复制六个相应级别。 请注意,目标纹理的顶级 MIP 级别的维度始终小于或等于源纹理的顶级 MIP 级别的维度。

源和目标句柄始终引用顶级图面,从不引用任何 MIP 映射子级别。

若要复制 MIP 贴图纹理的任意级别,运行时将改为调用驱动程序的 Blt 函数。

源纹理和目标纹理的像素格式相同,一般情况下,指定的比特作是安全的。

要求

要求 价值
最低支持的客户端 Windows 8
支持的最低服务器 Windows Server 2012
目标平台 桌面
标头 d3dumddi.h (包括 D3dumddi.h)

另请参阅

Blt

D3DDDIARG_TEXBLT1

D3DDDI_DEVICEFUNCS