ID3DXFile::CreateSaveObject method

Article
03/15/2021

Creates a save object that will be used to save data to a .x file.

Syntax

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

Parameters

pData [in]

Type: LPCVOID

Pointer to the name of the file to use for saving data.

flags [in]

Type: D3DXF_FILESAVEOPTIONS

Value that specifies the name of the file to which data is to be saved. This value can be one of the File Save Options flags.

dwFileFormat [in]

Type: D3DXF_FILEFORMAT

Indicates the format to use when saving the .x file. This value can be one of the File Formats flags. For more information, see Remarks.

ppSaveObj [out]

Type: ID3DXFileSaveObject**

Address of a pointer to an ID3DXFileSaveObject interface, representing the created save object.

Return value

Type: HRESULT

If the method succeeds, the return value is S_OK. If the method fails, the return value can be one of the following: D3DXFERR_BADVALUE, D3DXFERR_PARSEERROR.

Remarks

After using this method, use methods of the ID3DXFileSaveObject interface to create data objects and to save templates or data.

For the saved file format dwFileFormat, one of the binary, legacy binary, or text flags in File Formats must be specified. The file can be compressed by using the optional D3DXF_FILEFORMAT_COMPRESSED flag.

The file format values can be combined in a logical OR to create compressed text or compressed binary files. If you indicate that the file format should be text and compressed, the file will be written out first as text and then compressed. However, compressed text files are not as efficient as binary text files; in most cases, therefore, you will want to indicate binary and compressed.

Requirements

Requirement	Value
Header	D3DX9Xof.h
Library	D3dx9.lib