Метод ID3DXFile::CreateSaveObject

Создает объект сохранения, который будет использоваться для сохранения данных в X-файл.

Синтаксис

HRESULT CreateSaveObject(
  [in]  LPCVOID               pData,
  [in]  D3DXF_FILESAVEOPTIONS flags,
  [in]  D3DXF_FILEFORMAT      dwFileFormat,
  [out] ID3DXFileSaveObject   **ppSaveObj
);

Параметры

pData [in]

Тип: LPCVOID

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

flags [in]

Тип: D3DXF_FILESAVEOPTIONS

Значение, указывающее имя файла, в который необходимо сохранить данные. Это значение может быть одним из флагов параметров сохранения файла .

dwFileFormat [in]

Тип: D3DXF_FILEFORMAT

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

ppSaveObj [out]

Тип: ID3DXFileSaveObject**

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

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

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет S_OK. Если метод завершается ошибкой, возвращаемое значение может быть одним из следующих: D3DXFERR_BADVALUE, D3DXFERR_PARSEERROR.

Комментарии

После использования этого метода используйте методы интерфейса ID3DXFileSaveObject для создания объектов данных и сохранения шаблонов или данных.

Для сохраненного формата файла dwFileFormat необходимо указать один из двоичных, устаревших двоичных или текстовых флагов в форматах файлов . Файл можно сжать с помощью необязательного флага D3DXF_FILEFORMAT_COMPRESSED.

Значения формата файла можно объединить в логическую или для создания сжатых текстовых или двоичных файлов. Если указать, что формат файла должен быть текстовым и сжатым, файл сначала будет записан как текст, а затем сжат. Однако сжатые текстовые файлы не так эффективны, как двоичные текстовые файлы; Поэтому в большинстве случаев требуется указать двоичные и сжатые.

Требования

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

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

ID3DXFile

ID3DXFileSaveObject