D3DXLoadVolumeFromResource 函数
从资源加载卷。
语法
HRESULT D3DXLoadVolumeFromResource(
_In_ LPDIRECT3DVOLUME9 pDestVolume,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const D3DBOX *pDestBox,
_In_ HMODULE hSrcModule,
_In_ LPCSTR pSrcResource,
_In_ const D3DBOX *pSrcBox,
_In_ DWORD Filter,
_In_ D3DCOLOR ColorKey,
_In_ D3DXIMAGE_INFO *pSrcInfo
);
参数
-
pDestVolume [in]
-
指向 IDirect3DVolume9 接口的 指针。 指定目标卷。
-
pDestPalette [in]
-
类型： const PALETTEENTRY*
指向 PALETTEENTRY 结构的指针，256 种颜色的目标调色板或 NULL。
-
pDestBox [in]
-
类型： const D3DBOX*
指向 D3DBOX 结构的指针。 指定目标框。 将此参数设置为 NULL 可指定整个卷。
-
hSrcModule [in]
-
类型： HMODULE
资源所在的模块的句柄;对于与操作系统用于创建当前进程的映像关联的模块，则为 NULL 。
-
pSrcResource [in]
-
类型： LPCSTR
指向指定源图像文件名的字符串的指针。 如果定义了 UNICODE 或 _UNICODE，则此参数类型为 LPCWSTR，否则类型为 LPCSTR。
-
pSrcBox [in]
-
类型： const D3DBOX*
指向 D3DBOX 结构的指针。 指定源框。 将此参数设置为 NULL 可指定整个卷。
-
筛选器 [in]
-
类型： DWORD
一个或多个 D3DX_FILTER的组合，控制图像的筛选方式。 为此参数指定D3DX_DEFAULT等效于指定D3DX_FILTER_TRIANGLE |D3DX_FILTER_DITHER。
-
ColorKey [in]
-
类型： D3DCOLOR
D3DCOLOR 值替换为透明黑色，或 0 表示禁用颜色键。 这始终是 32 位 ARGB 颜色，与源图像格式无关。 Alpha 非常重要，对于不透明颜色键，通常应设置为 FF。 因此，对于不透明的黑色，该值将等于 0xFF000000。
-
pSrcInfo [in]
-
类型： D3DXIMAGE_INFO*
指向要用源图像文件中数据的说明填充 的D3DXIMAGE_INFO 结构的指针，或 NULL。
返回值
类型： HRESULT
如果函数成功，则返回值D3D_OK。 如果函数失败，则返回值可以是以下值之一：D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA。
备注
正在加载的资源必须是位图资源 (RT_BITMAP) 。
此函数处理与压缩纹理格式的转换。
写入到卷纹理的非零级图面不会导致更新脏矩形。 如果调用了 D3DXLoadVolumeFromFile 并且纹理尚未脏 (这在) 正常使用方案中不太可能出现，则应用程序需要在卷纹理上显式调用 IDirect3DVolumeTexture9：：AddDirtyBox。
此函数支持 Unicode 和 ANSI 字符串。
要求
| 要求 | 值 |
|---|---|
| 标头 |
|
| 库 |
|
另请参阅