D3DXCreateTextureFromFileInMemoryEx函数

注:限于翻译水平限制,详情请查阅MSDN

 

D3DXCreateTextureFromFileInMemoryEx 函数
从内存文件创建一个纹理，这是个比D3DXCreateTextureFromFileInMemory更高级的函数。

语法
HRESULT WINAPI
    D3DXCreateTextureFromFileInMemoryEx(
        LPDIRECT3DDEVICE9         pDevice,
        LPCVOID                   pSrcData,
        UINT                      SrcDataSize,
        UINT                      Width,
        UINT                      Height,
        UINT                      MipLevels,
        DWORD                     Usage,
        D3DFORMAT                 Format,
        D3DPOOL                   Pool,
        DWORD                     Filter,
        DWORD                     MipFilter,
        D3DCOLOR                  ColorKey,
        D3DXIMAGE_INFO*           pSrcInfo,
        PALETTEENTRY*             pPalette,
        LPDIRECT3DTEXTURE9*       ppTexture);

注：LPDIRECT3DDEVICE8和LPDIRECT3DTEXTURE9因SDK版本而异。

参数
pDevice [输入]
类型: LPDIRECT3DDEVICE9

IDirect3DDevice9接口的指针，代表与纹理关联的设备。

pSrcData [输入]
类型: LPCVOID

用以创建纹理的内存文件的指针。

SrcDataSize [输入]
类型: UINT

内存文件的大小，以字节为单位。

Width [输入]
类型: UINT

宽度，以像素为单位。如果值为零或D3DX_DEFAULT，则尺寸由文件决定。

Height [输入]
类型: UINT

高度，以像素为单位。如果值为零或D3DX_DEFAULT，则尺寸由文件决定。

MipLevels [输入]
类型: UINT

请求的Mip层级（mip levels）， 如果值为零或D3DX_DEFAULT，完整mipmap链将被创建。

Usage [输入]
类型: DWORD

0，D3DUSAGE_RENDERTARGET或D3DUSAGE_DYNAMIC。设此标志为D3DUSAGE_RENDERTARGET指明表面作为一个渲染目标。资源便可传递给

SetRenderTarget方法的pNewRenderTarget参数。如果D3DUSAGE_RENDERTARGET和D3DUSAGE_DYNAMIC都不置位，则Pool必须设为

D3DPOOL_DEFAULT，一个程序应该调用CheckDeviceFormat来检查设备是否支持此操作。关于动态纹理的更多信息，参阅使用动态纹理

（Dynamic Textures）。

Format [输入]
类型: D3DFORMAT

枚举类型D3DFORMAT的成员，描述纹理的像素模式。返回的纹理的格式可能与Format指定的不同。应用程序应该检查返回的纹理的格式。

如果设为D3DFMT_UNKNOWN，则格式由文件决定。如果设为D3DFMT_FROM_FILE，则格式完全与文件相同，而格式与设备性能冲突时函数会失

败。

Pool [输入]
类型: D3DPOOL

枚举类型D3DPOOL成员，描述纹理应该置于何种内存类型。

Filter [输入]
类型: DWORD

一个或多个标志的组合以控制图形的过滤，设置D3DX_DEFAULT位等效于设置D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER。任何有效的标

志应为D3DX_FILTER之一。

MipFilter [输入]
类型: DWORD

一个或多个标志的组合以控制图形的过滤，设置D3DX_DEFAULT位等效于设置D3DX_FILTER_BOX。任何有效的标志应为D3DX_FILTER之一。另

外，使用27-31来指定要忽略的mip层级（从mipmap链的顶部开始），当一个.dds纹理被加载到内存，允许最多忽略32个层级。

ColorKey [输入]
类型: D3DCOLOR

被透明黑色取代的D3DCOLOR值，或设为0以禁用透明色。它总是一个32位ARGB颜色，与源文件的图像格式无关。Alpha字段是有意义的且常

常设为FF填充（屏蔽）透明色，所以，要不透明黑色，其值应取0xFF000000。

pSrcInfo [输入，输出]
类型: D3DXIMAGE_INFO*

D3DXIMAGE_INFO结构的指针，用以填充原始文件数据的描述，可设为NULL。

pPalette [输出]
类型: PALETTEENTRY*

PALETTEENTRY结构的指针，代表一个要填充的256色调色板，或设为NULL，见备注。

ppTexture [输出]
类型: LPDIRECT3DTEXTURE9*

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

返回值
类型: HRESULT

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

备注
次函数支持如下文件格式：.bmp，.dds，.dib，.hdr，.jpg，.pfm，.png，.ppm和.tga。见D3DXIMAGE_FILEFORMAT。

关于PALETTEENTRY的详情，参考平台SDK。注意在DirectX 8.0，PALETTEENTRY结构的成员peFlags并不是平台SDK文档所说的那样工作。

peFlags成员现在是8位调色板格式的alpha通道。

当忽略mipmap层级来夹在一个.dds文件时，使用宏D3DX_SKIP_DDS_MIP_LEVELS来生成MipFilter的值。该宏使用忽略的层级数和过滤类型作

为参数，返回一个能传递给MipFilter参数的过滤值。

需求条件
文件头
 D3dx9tex.h
库
 D3dx9.lib

参阅
D3DXCreateTextureFromFileInMemory
D3DX9的纹理函数