Método ID3DXFile::CreateSaveObject

Crea un objeto de guardado que se usará para guardar datos en un archivo .x.

Sintaxis

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

Parámetros

pData [in]

Tipo: LPCVOID

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

flags [in]

Tipo: D3DXF_FILESAVEOPTIONS

Valor que especifica el nombre del archivo en el que se van a guardar los datos. Este valor puede ser una de las marcas Opciones de guardado de archivos .

dwFileFormat [in]

Tipo: D3DXF_FILEFORMAT

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

ppSaveObj [out]

Tipo: ID3DXFileSaveObject**

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

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto se S_OK. Si se produce un error en el método, el valor devuelto puede ser uno de los siguientes: D3DXFERR_BADVALUE, D3DXFERR_PARSEERROR.

Comentarios

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

Para el formato de archivo guardado dwFileFormat, se debe especificar una de las marcas binarias, binarias heredadas o de texto en formatos de archivo. El archivo se puede comprimir mediante la marca opcional D3DXF_FILEFORMAT_COMPRESSED.

Los valores de formato de archivo se pueden combinar en un or lógico para crear archivos binarios comprimidos o de texto comprimido. 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; en la mayoría de los casos, por lo tanto, querrá indicar binarios y comprimidos.

Requisitos

Requisito	Value
Encabezado	D3DX9Xof.h
Biblioteca	D3dx9.lib

Consulte también

ID3DXFile

ID3DXFileSaveObject