D3DXCreateCubeTexture 函数
创建空立方体纹理，根据需要调整调用参数。
语法
HRESULT D3DXCreateCubeTexture(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ UINT Size,
_In_ UINT MipLevels,
_In_ DWORD Usage,
_In_ D3DFORMAT Format,
_In_ D3DPOOL Pool,
_Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);
parameters
-
pDevice [in]
-
指向 IDirect3DDevice9 接口的指针，表示要与纹理关联的设备。
-
大小 [in]
-
类型： UINT
立方体纹理的宽度和高度（以像素为单位）。 例如，如果立方体纹理是 8 像素 x 8 像素立方体，则此参数的值应为 8。
-
MipLevels [in]
-
类型： UINT
请求的 mip 级别数。 如果此值为零或D3DX_DEFAULT，则会创建完整的 mipmap 链。
-
用法 [in]
-
类型： DWORD
0、D3DUSAGE_RENDERTARGET 或 D3DUSAGE_DYNAMIC。 将此标志设置为D3DUSAGE_RENDERTARGET表示该图面将用作呈现目标。 然后，可以将资源传递给 SetRenderTarget 方法的 pNewRenderTarget 参数。 如果指定了D3DUSAGE_RENDERTARGET，则应用程序应通过调用 CheckDeviceFormat 检查设备支持此操作。 有关使用动态纹理的详细信息，请参阅 使用动态纹理。
-
格式 [in]
-
类型： D3DFORMAT
D3DFORMAT 枚举类型的成员，描述多维数据集纹理的请求像素格式。 返回的立方体纹理的格式可能与 Format 指定的格式不同。 应用程序应检查返回的多维数据集纹理的格式。
-
池 [in]
-
类型： D3DPOOL
D3DPOOL 枚举类型的成员，描述应放置立方体纹理的内存类。
-
ppCubeTexture [out]
-
指向 IDirect3DCubeTexture9 接口的指针的地址，表示创建的立方体纹理对象。
返回值
类型： HRESULT
如果函数成功，则返回值D3D_OK。 如果函数失败，则返回值可以是下列值之一：D3DERR_INVALIDCALL、D3DERR_NOTAVAILABLE、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORY。
备注
立方体纹理与其他表面的不同之处在于，它们是图面的集合。
在内部，D3DXCreateCubeTexture 使用 D3DXCheckCubeTextureRequirements 来调整调用参数。 因此，调用 D3DXCreateCubeTexture 通常会成功，而对 CreateCubeTexture 的调用会失败。
要求
| 要求 | 值 |
|---|---|
| 标头 |
|
| 库 |
|
请参阅