D3DXCreateTextureFromResourceEx 函数

  • 项目

从资源创建纹理。 这是比 D3DXCreateTextureFromResource 更高级的函数。

语法

HRESULT D3DXCreateTextureFromResourceEx(
  _In_    LPDIRECT3DDEVICE9  pDevice,
  _In_    HMODULE            hSrcModule,
  _In_    LPCTSTR            pSrcResource,
  _In_    UINT               Width,
  _In_    UINT               Height,
  _In_    UINT               MipLevels,
  _In_    DWORD              Usage,
  _In_    D3DFORMAT          Format,
  _In_    D3DPOOL            Pool,
  _In_    DWORD              Filter,
  _In_    DWORD              MipFilter,
  _In_    D3DCOLOR           ColorKey,
  _Inout_ D3DXIMAGE_INFO     *pSrcInfo,
  _Out_   PALETTEENTRY       *pPalette,
  _Out_   LPDIRECT3DTEXTURE9 *ppTexture
);

parameters

pDevice [in]

类型： LPDIRECT3DDEVICE9

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

hSrcModule [in]

类型： HMODULE

资源所在的模块的句柄;对于与操作系统用于创建当前进程的映像关联的模块，则为 NULL 。

pSrcResource [in]

类型： LPCTSTR

指向指定资源名称的字符串的指针。 如果编译器设置需要 Unicode，则数据类型 LPCTSTR 解析为 LPCWSTR。 否则，字符串数据类型解析为 LPCSTR。 请参阅“备注”。

Width [in]

类型： UINT

宽度（以像素为单位）。 如果此值为零或D3DX_DEFAULT，则维度取自文件。

高度 [in]

类型： UINT

高度（以像素为单位）。 如果此值为零或D3DX_DEFAULT，则维度取自文件。

MipLevels [in]

类型： UINT

请求的 mip 级别数。 如果此值为零或D3DX_DEFAULT，则会创建完整的 mipmap 链。

用法 [in]

类型： DWORD

0、D3DUSAGE_RENDERTARGET 或 D3DUSAGE_DYNAMIC。 将此标志设置为D3DUSAGE_RENDERTARGET表示该图面将用作呈现目标。 然后，可以将资源传递给 SetRenderTarget 方法的 pNewRenderTarget 参数。 如果指定了 D3DUSAGE_RENDERTARGET 或 D3DUSAGE，则必须将 Pool 设置为 D3DPOOL_DEFAULT，并且应用程序应通过调用 CheckDeviceFormat 检查设备支持此操作。 D3DUSAGE_DYNAMIC指示应动态处理图面。 有关使用动态纹理的详细信息，请参阅 (Direct3D 9 的性能优化) 使用动态纹理。

格式 [in]

类型： D3DFORMAT

D3DFORMAT 枚举类型的成员，描述纹理请求的像素格式。 返回的纹理的格式可能与 Format 指定的格式不同。 应用程序应检查返回的纹理的格式。 如果 D3DFMT_UNKNOWN，则格式取自文件。 如果D3DFMT_FROM_FILE，则采用的格式与文件中的格式完全相同，如果这违反了设备功能，调用将失败。

池 [in]

类型： D3DPOOL

D3DPOOL 枚举类型的成员，描述应放置纹理的内存类。

筛选器 [in]

类型： DWORD

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

MipFilter [in]

类型： DWORD

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

ColorKey [in]

类型： D3DCOLOR

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

pSrcInfo [in， out]

类型： D3DXIMAGE_INFO*

指向要用源图像文件中数据的说明填充 的D3DXIMAGE_INFO 结构的指针，或 NULL。

pPalette [out]

类型： PALETTEENTRY*

指向 PALETTEENTRY 结构的指针，表示要填充的 256 色调色板或 NULL。

ppTexture [out]

类型： LPDIRECT3DTEXTURE9*

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

返回值

类型： HRESULT

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

备注

编译器设置还确定函数版本。 如果定义了 Unicode，则函数调用将解析为 D3DXCreateTextureFromResourceExW。 否则，函数调用将解析为 D3DXCreateTextureFromResourceExA，因为正在使用 ANSI 字符串。

要加载的资源的类型必须为 RT_BITMAP 或 RT_RCDATA。 资源类型RT_RCDATA用于加载位图 (以外的格式，例如 .tga、.jpg 和 .dds) 。

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

要求

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

请参阅

D3DXCreateTextureFromResource

D3DX 9 中的纹理函数