D3DXCreateTextureFromFileInMemory 函数

从内存中的文件创建纹理。

语法

HRESULT D3DXCreateTextureFromFileInMemory(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  LPCVOID            pSrcData,
  _In_  UINT               SrcDataSize,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

参数

pDevice [in]

类型: LPDIRECT3DDEVICE9

指向表示要与纹理关联的设备的 IDirect3DDevice9 接口的指针。

pSrcData [in]

类型: LPCVOID

指向内存中要从中创建纹理的文件的指针。

SrcDataSize [in]

类型: UINT

内存中文件的大小(以字节为单位)。

ppTexture [out]

类型: LPDIRECT3DTEXTURE9*

指向表示创建的纹理对象的 IDirect3DTexture9 接口的指针的地址。

返回值

类型: HRESULT

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

备注

该函数等效于 D3DXCreateTextureFromFileInMemoryEx (pDevice、pSrcData、SrcDataSize、D3DX_DEFAULT、D3DX_DEFAULT、D3DX_DEFAULT、0、D3DFMT_UNKNOWN、D3DPOOL_MANAGED、D3DX_DEFAULT、D3DX_DEFAULT、0、 NULLNULL、ppTexture) 。

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

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

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

要求

要求
标头
D3dx9tex.h

D3dx9.lib

另请参阅

D3DXCreateTextureFromFileInMemoryEx

D3DX 9 中的纹理函数