Функция 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
Комментарии
Параметр компилятора также определяет версию функции. Если определен Юникод, вызов функции разрешается в D3DXSaveVolumeToFileW. В противном случае вызов функции разрешается в >D3DXSaveVolumeToFileA, так как используются строки ANSI.
Эта функция обрабатывает преобразование в сжатые форматы текстур и из нее.
Если том нединамический (из-за того, что параметр использования при создании имеет значение 0) и находится в видеопамяти (пул памяти, для D3DPOOL_DEFAULT), D3DXSaveTextureToFile завершится сбоем, так как D3DX не может заблокировать нединамические тома, расположенные в видеопамяти.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел