Metodo IDirectXFile::CreateSaveObject
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 |
|
Libreria |
|
Vedi anche