Método IDirectXFile::CreateSaveObject

Crea un objeto save. En desuso.

Sintaxis

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

Parámetros

szFileName [in]

Tipo: LPCSTR

Puntero al nombre del archivo que se va a usar para guardar datos.

dwFileFormat [in]

Tipo: DXFILEFORMAT

Indica el formato que se va a usar al guardar el archivo DirectX. Este valor puede ser una de las marcas de DXFILEFORMAT_xxx en constantes DXFILE. Para obtener más información, vea la sección Comentarios.

ppSaveObj [out, retval]

Tipo: LPDIRECTXFILESAVEOBJECT*

Dirección de un puntero a una interfaz IDirectXFileSaveObject , que representa el objeto save creado.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es DXFILE_OK. Si se produce un error en el método, el valor devuelto puede ser uno de los siguientes: DXFILEERR_BADALLOC, DXFILEERR_BADFILE, DXFILEERR_BADVALUE.

Comentarios

Después de usar este método, use métodos de la interfaz IDirectXFileSaveObject para crear objetos de datos y guardar plantillas o datos.

El valor predeterminado para el formato de archivo es DXFILEFORMAT_BINARY. Los valores de formato de archivo se pueden combinar en un or lógico para crear archivos binarios comprimidos o de texto comprimido. Si se especifica un archivo como binario (0) y texto (1), se guardará como un archivo de texto porque el valor será indistinguible del valor de formato de archivo de texto (0 + 1 = 1). Si indica que el formato de archivo debe ser texto y comprimido, el archivo se escribirá primero como texto y, a continuación, se comprimirá. Sin embargo, los archivos de texto comprimidos no son tan eficaces como archivos de texto binario, por lo que en la mayoría de los casos querrá indicar binario y comprimido. Si se establece un archivo que se va a comprimir sin especificar un formato, se producirá un archivo binario comprimido.

Requisitos

Requisito	Value
Encabezado	DXFile.h
Biblioteca	D3dxof.lib

Consulte también

IDirectXFile

IDirectXFileSaveObject