ID3D10Device::CreateTexture3D 方法 (d3d10.h)
创建单个 3D 纹理 (请参阅 Texture3D) 。
语法
HRESULT CreateTexture3D(
[in] const D3D10_TEXTURE3D_DESC *pDesc,
[in] const D3D10_SUBRESOURCE_DATA *pInitialData,
[out] ID3D10Texture3D **ppTexture3D
);
参数
[in] pDesc
类型: const D3D10_TEXTURE3D_DESC*
指向 3D 纹理说明的指针 (请参阅 D3D10_TEXTURE3D_DESC) 。 若要创建可在运行时解释为不同兼容格式的无类型资源,请在纹理说明中指定无类型格式。 若要自动生成 mipmap 级别,请将 mipmap 级别数设置为 0。
[in] pInitialData
类型: const D3D10_SUBRESOURCE_DATA*
指向 子资源 说明数组的指针, (请参阅 D3D10_SUBRESOURCE_DATA) ;每个子资源 (按纹理数组索引、切片索引、mip 级别) 排序。 创建 IMMUTABLE 资源时,应用程序可能不会为 pInitialData 指定 NULL , (请参阅 D3D10_USAGE) 。 如果资源是多重采样的,pInitialData 必须为 NULL ,因为多重采样资源在创建时无法使用数据进行初始化。
[out] ppTexture3D
类型: ID3D10Texture3D**
指向所创建纹理的指针的地址 (请参阅 ID3D10Texture3D 接口) 。 将此参数设置为 NULL 以验证其他输入参数, (如果其他输入参数通过验证) ,该方法将返回S_FALSE。
返回值
类型: HRESULT
如果方法成功,则返回代码S_OK。 有关失败的错误代码,请参阅 Direct3D 10 返回 代码。
注解
CreateTexture3D 创建一个包含 1D 纹理数组的 3D 纹理资源。 纹理说明中指定了纹理数量。 资源中的所有纹理必须具有相同的格式、大小和 mipmap 级别数。
所有资源都由一个或多个 子资源组成。 若要将数据加载到纹理中,应用程序最初可以提供数据作为 pInitialData 指向 的D3D10_SUBRESOURCE_DATA 结构的一部分,也可以使用 SDK 提供的 纹理函数 之一。
要求
目标平台 | Windows |
标头 | d3d10.h |
Library | D3D10.lib |