D3DXCreateVolumeTextureFromResourceEx 函数

项目
06/13/2023

从字符串指定的资源创建卷纹理。这是比 D3DXCreateVolumeTextureFromResource 更高级的函数。

语法

HRESULT D3DXCreateVolumeTextureFromResourceEx(
  _In_    LPDIRECT3DDEVICE9        pDevice,
  _In_    HMODULE                  hSrcModule,
  _In_    LPCTSTR                  pSrcResource,
  _In_    UINT                     Width,
  _In_    UINT                     Height,
  _In_    UINT                     Depth,
  _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_   LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);

参数

pDevice [in]

类型： LPDIRECT3DDEVICE9

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

hSrcModule [in]

类型： HMODULE

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

pSrcResource [in]

类型： LPCTSTR

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

Width [in]

类型： UINT

宽度（以像素为单位）。如果此值为零或D3DX_DEFAULT，则维度取自文件。驱动程序支持的宽度、高度和深度) (的最大尺寸可以在 D3DCAPS9 中的 MaxVolumeExtent 中找到。

高度 [in]

类型： UINT

高度（以像素为单位）。如果此值为零或D3DX_DEFAULT，则维度取自文件。驱动程序支持的宽度、高度和深度) (的最大尺寸可以在 D3DCAPS9 中的 MaxVolumeExtent 中找到。

深度 [in]

类型： UINT

深度（以像素为单位）。如果此值为零或D3DX_DEFAULT，则维度取自文件。驱动程序支持的宽度、高度和深度) (的最大尺寸可以在 D3DCAPS9 中的 MaxVolumeExtent 中找到。

MipLevels [in]

类型： UINT

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

用法 [in]

类型： DWORD

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

格式 [in]

类型： D3DFORMAT

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

池 [in]