IDirect3DDevice9：：CreateTexture 方法 (d3d9helper.h)

项目
02/26/2024

创建纹理资源。

语法

HRESULT CreateTexture(
  [in]          UINT              Width,
  [in]          UINT              Height,
  [in]          UINT              Levels,
  [in]          DWORD             Usage,
  [in]          D3DFORMAT         Format,
  [in]          D3DPOOL           Pool,
  [out, retval] IDirect3DTexture9 **ppTexture,
  [in]          HANDLE            *pSharedHandle
);

参数

[in] Width

类型： UINT

纹理顶层的宽度（以像素为单位）。后续级别的像素尺寸将是前一级别像素维度的一半的截断值， (独立) 。每个维度的大小为 1 个像素。因此，如果除以 2 的结果为 0，则取 1。

[in] Height

类型： UINT

纹理顶层的高度（以像素为单位）。后续级别的像素尺寸将是前一级别像素维度的一半的截断值， (独立) 。每个维度的大小为 1 个像素。因此，如果除以 2 的结果为 0，则取 1。

[in] Levels

类型： UINT

纹理中的级别数。如果为零，则 Direct3D 将为支持误贴纹理的硬件生成 1 x 1 像素的所有纹理子级别。调用 IDirect3DBaseTexture9：：GetLevelCount 以查看生成的级别数。

[in] Usage

类型： DWORD

使用情况可以为 0，这表示没有使用值。但是，如果需要使用，请使用一个或多个 D3DUSAGE 常量的组合。最好将 usage 参数与 IDirect3D9：：CreateDevice 中的行为标志相匹配。

[in] Format

类型： D3DFORMAT

D3DFORMAT枚举类型的成员，描述纹理中所有级别的格式。

[in] Pool

类型： D3DPOOL

D3DPOOL枚举类型的成员，描述应在其中放置纹理的内存类。

[out, retval] ppTexture

类型： IDirect3DTexture9**

指向 IDirect3DTexture9 接口的指针，表示创建的纹理资源。

[in] pSharedHandle

类型： HANDLE*

保留。将此参数设置为 NULL。此参数可用于 Windows Vista 的 Direct3D 9 中共享资源。

返回值

类型： HRESULT

如果该方法成功，则返回值D3D_OK。如果方法失败，则返回值可以是下列值之一：D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORY。

注解

应用程序可以使用 D3DUSAGE_AUTOGENMIPMAP 调用 IDirect3D9：：CheckDeviceFormat，发现对特定格式的 Mipmap (Direct3D 9) 自动生成的支持。如果 IDirect3D9：：CheckDeviceFormat 返回D3DOK_NOAUTOGEN， 则 IDirect3DDevice9：：CreateTexture 将成功，但它将返回一级纹理。

在 Windows Vista 中，CreateTexture 可以从系统内存指针创建纹理，使应用程序能够更灵活地使用、分配和删除系统内存。例如，应用程序可以传递 GDI 系统内存位图指针，并获取其周围的 Direct3D 纹理接口。将系统内存指针与 CreateTexture 结合使用具有以下限制。

纹理的间距必须等于宽度乘以每个像素的字节数。
仅支持具有单个 mipmap 级别的纹理。 Levels 参数必须为 1。
池 参数必须 D3DPOOL_SYSTEMMEM。
pSharedHandle 参数必须是指向可以保存系统内存点的缓冲区的有效指针;*pSharedHandle 必须是指向系统内存的有效指针，大小为纹理宽度 * 纹理高度 * 每像素纹理格式的字节数。