Función D3DXSaveVolumeToFile

Guarda un volumen en un archivo en el disco.

Sintaxis

HRESULT D3DXSaveVolumeToFile(
  _In_       LPCTSTR              pDestFile,
  _In_       D3DXIMAGE_FILEFORMAT DestFormat,
  _In_       LPDIRECT3DVOLUME9    pSrcVolume,
  _In_ const PALETTEENTRY         *pSrcPalette,
  _In_ const D3DBOX               *pSrcBox
);

Parámetros

pDestFile [in]

Tipo: LPCTSTR

Puntero a una cadena que especifica el nombre de archivo de la imagen de destino. Si la configuración del compilador requiere Unicode, el tipo de datos LPCTSTR se resuelve en LPCWSTR. De lo contrario, el tipo de datos de cadena se resuelve en LPCSTR. Vea la sección Comentarios.

DestFormat [in]

Tipo: D3DXIMAGE_FILEFORMAT

D3DXIMAGE_FILEFORMAT especificar el formato de archivo que se va a usar al guardar. Esta función permite guardar en todos los formatos de D3DXIMAGE_FILEFORMAT excepto Portable Pixmap (.ppm) y Targa/Truevision Graphics Adapter (.tga).

pSrcVolume [in]

Tipo: LPDIRECT3DVOLUME9

Puntero a la interfaz IDirect3DVolume9 que contiene la imagen que se va a guardar.

pSrcPalette [in]

Tipo: const PALETTEENTRY*

Puntero a una estructura PALETTEENTRY que contiene una paleta de 256 colores. Este parámetro puede ser NULL.

pSrcBox [in]

Tipo: const D3DBOX*

Puntero a una estructura D3DBOX . Especifica el cuadro de origen. Establezca este parámetro en NULL para especificar todo el volumen.

Valor devuelto

Tipo: HRESULT

Si la función se realiza correctamente, el valor devuelto se D3D_OK. Si se produce un error en la función, el valor devuelto puede ser el siguiente: D3DERR_INVALIDCALL

Comentarios

La configuración del compilador también determina la versión de la función. Si se define Unicode, la llamada de función se resuelve en D3DXSaveVolumeToFileW. De lo contrario, la llamada de función se resuelve en >D3DXSaveVolumeToFileA porque se usan cadenas ANSI.

Esta función controla la conversión a y desde formatos de textura comprimidos.

Si el volumen no es dinámico (debido a un parámetro de uso establecido en 0 en la creación) y se encuentra en la memoria de vídeo (el grupo de memoria establecido en D3DPOOL_DEFAULT), D3DXSaveTextureToFile producirá un error porque D3DX no puede bloquear volúmenes no dinámicos ubicados en la memoria de vídeo.

Requisitos

Requisito	Value
Encabezado	D3dx9tex.h
Biblioteca	D3dx9.lib

Consulte también

Funciones de textura en D3DX 9

D3DXSaveSurfaceToFile

D3DXSaveTextureToFile

D3DXSaveVolumeToFileInMemory