D3DXLoadSurfaceFromMemory 函数

从内存加载图面。

语法

HRESULT D3DXLoadSurfaceFromMemory(
  _In_       LPDIRECT3DSURFACE9 pDestSurface,
  _In_ const PALETTEENTRY       *pDestPalette,
  _In_ const RECT               *pDestRect,
  _In_       LPCVOID            pSrcMemory,
  _In_       D3DFORMAT          SrcFormat,
  _In_       UINT               SrcPitch,
  _In_ const PALETTEENTRY       *pSrcPalette,
  _In_ const RECT               *pSrcRect,
  _In_       DWORD              Filter,
  _In_       D3DCOLOR           ColorKey
);

parameters

pDestSurface [in]

类型: LPDIRECT3DSURFACE9

指向 IDirect3DSurface9 接口的指针。 指定接收图像的目标图面。

pDestPalette [in]

类型: const PALETTEENTRY*

指向 PALETTEENTRY 结构、256 种颜色的目标调色板或 NULL 的指针。

pDestRect [in]

类型: const RECT*

指向 RECT 结构的指针。 指定目标矩形。 将此参数设置为 NULL 以指定整个图面。

pSrcMemory [in]

类型: LPCVOID

指向内存中源图像左上角的指针。

SrcFormat [in]

类型: D3DFORMAT

D3DFORMAT 枚举类型的成员,源图像的像素格式。

SrcPitch [in]

类型: UINT

源图像的间距(以字节为单位)。 对于 DXT 格式,此数字应表示一行单元格的宽度(以字节为单位)。

pSrcPalette [in]

类型: const PALETTEENTRY*

指向 PALETTEENTRY 结构的指针,该结构为 256 种颜色的源调色板或 NULL

pSrcRect [in]

类型: const RECT*

指向 RECT 结构的指针。 指定内存中源图像的尺寸。 此值不能为 NULL

筛选 [in]

类型: DWORD

控制图像筛选方式的一个或多个 D3DX_FILTER 的组合。 为此参数指定D3DX_DEFAULT等效于指定D3DX_FILTER_TRIANGLE |D3DX_FILTER_DITHER。

ColorKey [in]

类型: D3DCOLOR

要替换为透明黑色的 D3DCOLOR 值,或 0 表示禁用颜色键。 这始终是 32 位 ARGB 颜色,与源图像格式无关。 Alpha 非常重要,对于不透明颜色键,通常应设置为 FF。 因此,对于不透明的黑色,该值将等于 0xFF000000。

返回值

类型: HRESULT

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

备注

此函数处理与压缩纹理格式的转换。

写入非零级图面不会导致更新脏矩形。 如果调用了 D3DXLoadSurfaceFromMemory,并且 surface 尚未脏 (这在正常使用方案中不太可能) ,则应用程序需要在 surface 上显式调用 AddDirtyRect

要求

要求
标头
D3dx9tex.h

D3dx9.lib

请参阅

D3DX 9 中的纹理函数