D3DXCreateCubeTextureFromFileInMemory 函数

  • 项目

从内存中的文件创建多维数据集纹理。

语法

HRESULT D3DXCreateCubeTextureFromFileInMemory(
  _In_  LPDIRECT3DDEVICE9      pDevice,
  _In_  LPCVOID                pSrcData,
  _In_  UINT                   SrcDataSize,
  _Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);

参数

pDevice [in]

类型： LPDIRECT3DDEVICE9

指向 IDirect3DDevice9 接口的指针，表示要与多维数据集纹理关联的设备。

pSrcData [in]

类型： LPCVOID

指向内存中要从中创建立方体映射的文件的指针。 请参阅“备注”。

SrcDataSize [in]

类型： UINT

内存中文件的大小（以字节为单位）。

ppCubeTexture [out]

类型： LPDIRECT3DCUBETEXTURE9*

指向 IDirect3DCubeTexture9 接口的指针的地址，表示创建的多维数据集纹理对象。

返回值

类型： HRESULT

如果函数成功，则返回值D3D_OK。 如果函数失败，则返回值可以是以下值之一：D3DERR_INVALIDCALL、D3DERR_NOTAVAILABLE、D3DERR_OUTOFVIDEOMEMORY、D3DXERR_INVALIDDATA E_OUTOFMEMORY。

备注

此函数支持以下文件格式：.bmp、.dds、.dib、.hdr、.jpg、.pfm、.png、.ppm 和 .tga。 请参阅 D3DXIMAGE_FILEFORMAT。

函数等效于 D3DXCreateCubeTextureFromFileInMemoryEx (pDevice、pSrcData、SrcDataSize、D3DX_DEFAULT、D3DX_DEFAULT、0、D3DFMT_UNKNOWN、D3DPOOL_MANAGED、D3DX_DEFAULT、D3DX_DEFAULT、0、 NULL、 NULL、ppCubeTexture) 。

请注意，从 IDirect3DDevice9 对象调用时，使用此函数创建的资源将放置在由 D3DPOOL_MANAGED 表示的内存类中。 当从 IDirect3DDevice9Ex 对象调用此方法时，资源将放在由 D3DPOOL_DEFAULT 表示的内存类中。

此方法旨在用于加载存储为 RT_RCDATA 的图像文件，这是应用程序定义的资源， (原始数据) 。 否则此方法将失败。

筛选会自动应用于使用此方法创建的纹理。 筛选等效于 D3DX_FILTER_TRIANGLE |D3DX_FILTER 中的 D3DX_FILTER_DITHER。

D3DXCreateCubeTextureFromFileInMemory 使用 DirectDraw surface (DDS) 文件格式。 DirectX 纹理编辑器 (Dxtex.exe) 使你能够从其他文件格式生成多维数据集映射，并将其保存为 DDS 文件格式。 可以从 DirectX SDK 获取Dxtex.exe并了解它。 有关 DirectX SDK 的信息，请参阅 DirectX SDK 在哪里？。

要求

要求 值
标头
D3dx9tex.h
库
D3dx9.lib

另请参阅

D3DX 9 中的纹理函数