Compartilhar via


Método ID3DXFile::CreateSaveObject

Cria um objeto save que será usado para salvar dados em um arquivo .x.

Sintaxe

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

Parâmetros

pData [in]

Tipo: LPCVOID

Ponteiro para o nome do arquivo a ser usado para salvar dados.

sinalizadores [in]

Tipo: D3DXF_FILESAVEOPTIONS

Valor que especifica o nome do arquivo no qual os dados devem ser salvos. Esse valor pode ser um dos sinalizadores opções de salvamento de arquivo.

dwFileFormat [in]

Tipo: D3DXF_FILEFORMAT

Indica o formato a ser usado ao salvar o arquivo .x. Esse valor pode ser um dos sinalizadores de Formatos de Arquivo . Para obter mais informações, consulte Comentários.

ppSaveObj [out]

Tipo: ID3DXFileSaveObject**

Endereço de um ponteiro para uma interface ID3DXFileSaveObject , representando o objeto save criado.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será S_OK. Se o método falhar, o valor retornado poderá ser um dos seguintes: D3DXFERR_BADVALUE, D3DXFERR_PARSEERROR.

Comentários

Depois de usar esse método, use métodos da interface ID3DXFileSaveObject para criar objetos de dados e salvar modelos ou dados.

Para o formato de arquivo salvo dwFileFormat, um dos sinalizadores binários, herdados ou de texto em Formatos de Arquivo deve ser especificado. O arquivo pode ser compactado usando o sinalizador de D3DXF_FILEFORMAT_COMPRESSED opcional.

Os valores de formato de arquivo podem ser combinados em um OR lógico para criar texto compactado ou arquivos binários compactados. Se você indicar que o formato do arquivo deve ser texto e compactado, o arquivo será gravado primeiro como texto e, em seguida, compactado. No entanto, os arquivos de texto compactados não são tão eficientes quanto arquivos de texto binário; na maioria dos casos, portanto, você desejará indicar binário e compactado.

Requisitos

Requisito Valor
parâmetro
D3DX9Xof.h
Biblioteca
D3dx9.lib

Confira também

ID3DXFile

ID3DXFileSaveObject