Método IDirectXFile::CreateSaveObject
Cria um objeto save. Preterido.
Sintaxe
HRESULT CreateSaveObject(
[in] LPCSTR szFileName,
[in] DXFILEFORMAT dwFileFormat,
[out, retval] LPDIRECTXFILESAVEOBJECT *ppSaveObj
);
Parâmetros
-
szFileName [in]
-
Tipo: LPCSTR
Ponteiro para o nome do arquivo a ser usado para salvar dados.
-
dwFileFormat [in]
-
Tipo: DXFILEFORMAT
Indica o formato a ser usado ao salvar o arquivo DirectX. Esse valor pode ser um dos sinalizadores de DXFILEFORMAT_xxx em constantes DXFILE. Para obter mais informações, consulte Comentários.
-
ppSaveObj [out, retval]
-
Tipo: LPDIRECTXFILESAVEOBJECT*
Endereço de um ponteiro para uma interface IDirectXFileSaveObject , representando o objeto save criado.
Valor retornado
Tipo: HRESULT
Se o método for bem-sucedido, o valor retornado será DXFILE_OK. Se o método falhar, o valor retornado poderá ser um dos seguintes: DXFILEERR_BADALLOC, DXFILEERR_BADFILE DXFILEERR_BADVALUE.
Comentários
Depois de usar esse método, use métodos da interface IDirectXFileSaveObject para criar objetos de dados e salvar modelos ou dados.
O valor padrão para o formato de arquivo é DXFILEFORMAT_BINARY. Os valores de formato de arquivo podem ser combinados em um OR lógico para criar texto compactado ou arquivos binários compactados. Se um arquivo for especificado como binário (0) e texto (1), ele será salvo como um arquivo de texto porque o valor será indistinguível do valor de formato de arquivo de texto (0 + 1 = 1). Se você indicar que o formato do arquivo deve ser texto e compactado, o arquivo será gravado primeiro como texto e compactado. No entanto, os arquivos de texto compactados não são tão eficientes quanto arquivos de texto binário, portanto, na maioria dos casos, você desejará indicar binário e compactado. Definir um arquivo a ser compactado sem especificar um formato resultará em um arquivo binário compactado.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|
Confira também