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