Metodo IDirectXFile::CreateSaveObject

  • Articolo

Crea un oggetto save. Deprecato.

Sintassi

HRESULT CreateSaveObject(
  [in]          LPCSTR                  szFileName,
  [in]          DXFILEFORMAT            dwFileFormat,
  [out, retval] LPDIRECTXFILESAVEOBJECT *ppSaveObj
);

Parametri

szFileName [in]

Tipo: LPCSTR

Puntatore al nome del file da usare per il salvataggio dei dati.

dwFileFormat [in]

Tipo: DXFILEFORMAT

Indica il formato da utilizzare per il salvataggio del file DirectX. Questo valore può essere uno dei flag DXFILEFORMAT_xxx nelle costanti DXFILE. Per altre informazioni, vedere la sezione Osservazioni.

ppSaveObj [out, retval]

Tipo: LPDIRECTXFILESAVEOBJECT*

Indirizzo di un puntatore a un'interfaccia IDirectXFileSaveObject che rappresenta l'oggetto save creato.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito viene DXFILE_OK. Se il metodo ha esito negativo, il valore restituito può essere uno dei seguenti: DXFILEERR_BADALLOC, DXFILEERR_BADFILE, DXFILEERR_BADVALUE.

Commenti

Dopo aver usato questo metodo, usare i metodi dell'interfaccia IDirectXFileSaveObject per creare oggetti dati e salvare modelli o dati.

Il valore predefinito per il formato di file è DXFILEFORMAT_BINARY. I valori del formato di file possono essere combinati in un OR logico per creare file binari compressi o di testo compresso. Se un file viene specificato sia come binario (0) che come testo (1), verrà salvato come file di testo perché il valore sarà indistinguibile dal valore del formato del file di testo (0 + 1 = 1). Se si indica che il formato del file deve essere testo e compresso, il file verrà prima scritto come testo e quindi compresso. Tuttavia, i file di testo compressi non sono altrettanto efficienti come file di testo binario, quindi nella maggior parte dei casi si vuole indicare file binari e compressi. L'impostazione di un file da comprimere senza specificare un formato comporterà un file binario compresso.

Requisiti

Requisito Valore
Intestazione
DXFile.h
Libreria
D3dxof.lib

Vedi anche

IDirectXFile

IDirectXFileSaveObject