IDirectXFileSaveObject：：CreateDataObject 方法

创建数据对象。 已弃用。

语法

HRESULT CreateDataObject(
  [in]                REFGUID           rguidTemplate,
  [in]                LPCSTR            szName,
  [in]          const GUID              *pguid,
  [in]                DWORD             cbSize,
  [in]                LPVOID            pvData,
  [out, retval]       LPDIRECTXFILEDATA *ppDataObj
);

参数

rguidTemplate [in]

类型： REFGUID

表示数据对象的模板的 GUID。

szName [in]

类型： LPCSTR

指向数据对象名称的指针。 如果对象没有名称，则指定 NULL 。

pguid [in]

类型： const GUID*

指向表示数据对象的 GUID 的指针。 如果对象没有 GUID，则指定 NULL 。

cbSize [in]

类型： DWORD

数据对象的大小（以字节为单位）。

pvData [in]

类型： LPVOID

指向包含所有必需成员数据的缓冲区的指针。

ppDataObj [out， retval]

类型： LPDIRECTXFILEDATA*

指向 IDirectXFileData 接口的指针的地址，表示创建的文件数据对象。

返回值

类型： HRESULT

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

备注

如果数据引用对象将引用数据对象，则 szName 或 pguid 参数必须为非 NULL。

保存此方法创建的数据之前，使用 IDirectXFileSaveObject：：SaveTemplates 方法保存任何模板。 使用 IDirectXFileSaveObject：：SaveData 方法保存创建的数据。

如果需要保存可选数据，请在使用此方法后和使用 IDirectXFileSaveObject：：SaveData 之前使用 IDirectXFileData：：AddDataObject 方法。 如果对象具有子对象，请在调用 IDirectXFileSaveObject：：SaveData 之前添加它们。

要求

要求	值
标头	DXFile.h
库	D3dxof.lib

另请参阅

IDirectXFileSaveObject

IDirectXFileData：：AddDataObject

IDirectXFileSaveObject：：SaveData

IDirectXFileSaveObject：：SaveTemplates