Метод IDirectXFile::CreateSaveObject
Создает объект сохранения. Не рекомендуется.
Синтаксис
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.
Комментарии
После использования этого метода используйте методы интерфейса IDirectXFileSaveObject для создания объектов данных и сохранения шаблонов или данных.
Значение по умолчанию для формата файла — DXFILEFORMAT_BINARY. Значения формата файлов можно объединить в логическую или для создания сжатых текстовых или сжатых двоичных файлов. Если файл указан как двоичный (0) и текстовый (1), он будет сохранен как текстовый файл, так как значение будет неотличимо от значения формата текстового файла (0 + 1 = 1). Если вы указываете, что формат файла должен быть текстовым и сжатым, файл сначала будет записан как текст, а затем сжат. Однако сжатые текстовые файлы не так эффективны, как двоичные текстовые файлы, поэтому в большинстве случаев требуется указать двоичные и сжатые файлы. Задание сжатого файла без указания формата приведет к созданию двоичного сжатого файла.
Требования
Требование | Значение |
---|---|
Заголовок |
|
Библиотека |
|
См. также раздел