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