Функция D3DXSaveVolumeToFile

Сохраняет том в файл на диске.

Синтаксис

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

Параметры

pDestFile [in]

Тип: LPCTSTR

Указатель на строку, указывающую имя файла целевого образа. Если для параметров компилятора требуется Юникод, тип данных LPCTSTR разрешается в LPCWSTR. В противном случае строковый тип данных разрешается в LPCSTR. См. заметки.

DestFormat [in]

Тип: D3DXIMAGE_FILEFORMAT

D3DXIMAGE_FILEFORMAT указание формата файла, используемого при сохранении. Эта функция поддерживает сохранение во всех форматах D3DXIMAGE_FILEFORMAT за исключением переносимого Pixmap (PPM) и Адаптера графики Targa/Truevision (TGA).

pSrcVolume [in]

Тип: LPDIRECT3DVOLUME9

Указатель на интерфейс IDirect3DVolume9 , содержащий сохраненный образ.

pSrcPalette [in]

Тип: const PALETTEENTRY*

Указатель на структуру PALETTEENTRY , содержащую палитру из 256 цветов. Этот параметр может принимать значение NULL.

pSrcBox [in]

Тип: const D3DBOX*

Указатель на структуру D3DBOX . Указывает исходное поле. Задайте для этого параметра значение NULL , чтобы указать весь том.

Возвращаемое значение

Тип: HRESULT

Если функция завершается успешно, возвращаемое значение D3D_OK. Если функция завершается ошибкой, возвращаемое значение может быть следующим: D3DERR_INVALIDCALL

Remarks

Параметр компилятора также определяет версию функции. Если определен Юникод, вызов функции разрешается в D3DXSaveVolumeToFileW. В противном случае вызов функции разрешается в >D3DXSaveVolumeToFileA, так как используются строки ANSI.

Эта функция обрабатывает преобразование в сжатые форматы текстур и из нее.

Если том не является нединамическим (из-за параметра использования, установленного на 0 при создании) и расположен в памяти видео (пул памяти, для D3DPOOL_DEFAULT), D3DXSaveTextureToFile завершится ошибкой, так как D3DX не может заблокировать нединамические тома, расположенные в памяти видео.

Требования

Требование Значение
Заголовок
D3dx9tex.h
Библиотека
D3dx9.lib

См. также раздел

Функции текстуры в D3DX 9

D3DXSaveSurfaceToFile

D3DXSaveTextureToFile

D3DXSaveVolumeToFileInMemory