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

另请参阅

ID3D10Device 接口