Функция D3DXSaveSurfaceToFile
Сохраняет поверхность в файл.
Синтаксис
HRESULT D3DXSaveSurfaceToFile(
_In_ LPCTSTR pDestFile,
_In_ D3DXIMAGE_FILEFORMAT DestFormat,
_In_ LPDIRECT3DSURFACE9 pSrcSurface,
_In_ const PALETTEENTRY *pSrcPalette,
_In_ const RECT *pSrcRect
);
Параметры
-
pDestFile [in]
-
Тип: LPCTSTR
Указатель на строку, указывающую имя файла целевого образа. Если для параметров компилятора требуется Юникод, тип данных LPCTSTR разрешается в LPCWSTR. В противном случае строковый тип данных разрешается в LPCSTR. См. заметки.
-
DestFormat [in]
-
Тип: D3DXIMAGE_FILEFORMAT
D3DXIMAGE_FILEFORMAT укажите формат файла, используемый при сохранении. Эта функция поддерживает сохранение во всех форматах D3DXIMAGE_FILEFORMAT , кроме переносимого Pixmap (PPM) и графического адаптера Targa/Truevision (TGA).
-
pSrcSurface [in]
-
Тип: LPDIRECT3DSURFACE9
Указатель на интерфейс IDirect3DSurface9 , содержащий сохраненное изображение.
-
pSrcPalette [in]
-
Тип: const PALETTEENTRY*
Указатель на структуру PALETTEENTRY , содержащую палитру из 256 цветов. Этот параметр может принимать значение NULL.
-
pSrcRect [in]
-
Тип: const RECT*
Указатель на структуру RECT . Задает исходный прямоугольник. Присвойте этому параметру значение NULL , чтобы указать весь образ.
Возвращаемое значение
Тип: HRESULT
Если функция выполняется успешно, возвращаемое значение будет D3D_OK. Если функция завершается сбоем, возвращаемое значение может быть следующим: D3DERR_INVALIDCALL
Комментарии
Параметр компилятора также определяет версию функции. Если определен Юникод, вызов функции разрешается в D3DXSaveSurfaceToFileW. В противном случае вызов функции разрешается в D3DXSaveSurfaceToFileA, так как используются строки ANSI.
Эта функция обрабатывает преобразование в сжатые форматы текстур и из нее.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел