ID3DXFile：：CreateSaveObject 方法

创建一个保存对象，该对象将用于将数据保存到 .x 文件。

语法

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

参数

pData [in]

类型： LPCVOID

指向用于保存数据的文件名称的指针。

flags [in]

类型： D3DXF_FILESAVEOPTIONS

一个值，该值指定要将数据保存到的文件的名称。 此值可以是 文件保存选项 标志之一。

dwFileFormat [in]

类型： D3DXF_FILEFORMAT

指示保存 .x 文件时要使用的格式。 此值可以是 文件格式 标志之一。 有关详细信息，请参阅“备注”。

ppSaveObj [out]

类型： ID3DXFileSaveObject**

指向 ID3DXFileSaveObject 接口的指针的地址，表示创建的保存对象。

返回值

类型： HRESULT

如果该方法成功，则返回值S_OK。 如果方法失败，则返回值可以是下列值之一：D3DXFERR_BADVALUE、D3DXFERR_PARSEERROR。

备注

使用此方法后，使用 ID3DXFileSaveObject 接口的方法创建数据对象并保存模板或数据。

对于保存的文件格式 dwFileFormat，必须指定 文件格式 中的二进制、旧二进制文件或文本标志之一。 可以使用可选的 D3DXF_FILEFORMAT_COMPRESSED 标志压缩文件。

文件格式值可以组合在逻辑 OR 中，以创建压缩文本或压缩的二进制文件。 如果指示文件格式应为文本和压缩格式，则文件将首先写出为文本，然后压缩。 但是，压缩文本文件不如二进制文本文件有效;因此，在大多数情况下，需要指示二进制和压缩。

要求

要求	值
标头	D3DX9Xof.h
库	D3dx9.lib

另请参阅

ID3DXFile

ID3DXFileSaveObject