D3DX10SaveTextureToFile 函数

将纹理保存到文件。

语法

HRESULT D3DX10SaveTextureToFile(
  _In_ ID3D10Resource           *pSrcTexture,
  _In_ D3DX10_IMAGE_FILE_FORMAT DestFormat,
  _In_ LPCTSTR                  pDestFile
);

parameters

pSrcTexture [in]

类型: ID3D10Resource*

指向要保存的纹理的指针。 请参阅 ID3D10Resource 接口

DestFormat [in]

类型: D3DX10_IMAGE_FILE_FORMAT

纹理将另存为的格式 (请参阅 D3DX10_IMAGE_FILE_FORMAT) 。 D3DX10_IFF_DDS 是首选格式,因为它是支持 DXGI_FORMAT 中的所有格式的唯 选项。

pDestFile [in]

类型: LPCTSTR

将保存纹理的目标输出文件的名称。 如果编译器设置需要 Unicode,则数据类型 LPCTSTR 解析为 LPCWSTR。 否则,数据类型将解析为 LPCSTR。

返回值

类型: HRESULT

返回值是 Direct3D 10 返回代码中列出的值之一;使用返回值查看 DestFormat 是否受支持。

备注

D3DX10SaveTextureToFile 仅在必要时写入输入纹理的额外 DDS_HEADER_DXT10 结构,例如 (,因为输入纹理采用标准 RGB (sRGB) 格式) 。 如果 D3DX10SaveTextureToFile 写出DDS_HEADER_DXT10结构,它将纹理DDS_PIXELFORMAT结构的 dwFourCC 成员设置为 DX10,以指示DDS_HEADER_DXT10扩展标头的预感。

要求

要求
标头
D3DX10Tex.h

D3DX10.lib

请参阅

D3DX 10 中的纹理函数

常规用途函数