IDirectXFile：：CreateSaveObject 方法

创建保存对象。 已弃用。

语法

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

参数

szFileName [in]

类型： LPCSTR

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

dwFileFormat [in]

类型： DXFILEFORMAT

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

ppSaveObj [out， retval]

类型： LPDIRECTXFILESAVEOBJECT*

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

返回值

类型： HRESULT

如果方法成功，则返回值DXFILE_OK。 如果方法失败，则返回值可以是以下值之一：DXFILEERR_BADALLOC、DXFILEERR_BADFILE、DXFILEERR_BADVALUE。

备注

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

文件格式的默认值为 DXFILEFORMAT_BINARY。 文件格式值可以组合在逻辑或 中，以创建压缩文本或压缩的二进制文件。 如果文件同时指定为二进制 (0) 和文本 (1) ，则会将其保存为文本文件，因为该值与文本文件格式值 (0 + 1 = 1) 无法区分。 如果指示文件格式应为文本和压缩格式，则文件将首先写出为文本，然后进行压缩。 但是，压缩文本文件不如二进制文本文件高效，因此在大多数情况下，需要指示二进制和已压缩。 在不指定格式的情况下将文件设置为压缩，将导致二进制压缩文件。

要求

另请参阅

IDirectXFile

IDirectXFileSaveObject