Метод IDirectXFile::CreateSaveObject

Статья
06/13/2023

Создает объект сохранения. Не рекомендуется.

Синтаксис

HRESULT CreateSaveObject(
  [in]          LPCSTR                  szFileName,
  [in]          DXFILEFORMAT            dwFileFormat,
  [out, retval] LPDIRECTXFILESAVEOBJECT *ppSaveObj
);

Параметры

szFileName [in]

Тип: LPCSTR

Указатель на имя файла, используемого для сохранения данных.

dwFileFormat [in]

Тип: DXFILEFORMAT

Указывает формат, используемый при сохранении файла DirectX. Это значение может быть одним из флагов DXFILEFORMAT_xxx в константах DXFILE. Дополнительные сведения см. в подразделе "Примечания".

ppSaveObj [out, retval]

Тип: LPDIRECTXFILESAVEOBJECT*

Адрес указателя на интерфейс IDirectXFileSaveObject , представляющий созданный объект сохранения.

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

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет DXFILE_OK. Если метод завершается ошибкой, возвращается одно из следующих значений: DXFILEERR_BADALLOC, DXFILEERR_BADFILE DXFILEERR_BADVALUE.

Значение по умолчанию для формата файла — DXFILEFORMAT_BINARY. Значения формата файлов можно объединить в логическую или для создания сжатых текстовых или сжатых двоичных файлов. Если файл указан как двоичный (0) и текстовый (1), он будет сохранен как текстовый файл, так как значение будет неотличимо от значения формата текстового файла (0 + 1 = 1). Если вы указываете, что формат файла должен быть текстовым и сжатым, файл сначала будет записан как текст, а затем сжат. Однако сжатые текстовые файлы не так эффективны, как двоичные текстовые файлы, поэтому в большинстве случаев требуется указать двоичные и сжатые файлы. Задание сжатого файла без указания формата приведет к созданию двоичного сжатого файла.

Требования

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

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

IDirectXFile
IDirectXFileSaveObject

Поделиться через