ID3DXFileSaveData::AddDataObject

Adds a data object as a child of the ID3DXFileSaveData file data node.

HRESULT AddDataObject(
  REFGUID rguidTemplate,
  LPCSTR szName,
  CONST GUID * pId,
  SIZE_T cbSize,
  LPCVOID pvData,
  ID3DXFileSaveData ** ppObj
);

Parameters

rguidTemplate

[in] GUID representing the data object's template.

szName

[in] Pointer to the name of the data object to add. Specify NULL if the object does not have a name.

pId

[in] Pointer to a GUID representing the data object. The data object must have been registered with ID3DXFile::RegisterTemplates or ID3DXFile::RegisterEnumTemplates. Specify NULL if the object does not have a GUID.

cbSize

[in] Size of the data object, in bytes.

pvData

[in] Pointer to a buffer containing all required data in the data object.

ppObj

[in, retval] Address of a pointer to an ID3DXFileSaveData interface, representing the file data node to which the data object will be added.

Return Values

If the method succeeds, the return value is S_OK. If the method fails, the return value can be one of the following: D3DXFERR_BADOBJECT, D3DXFERR_BADVALUE, E_OUTOFMEMORY.

Requirements

Header: Declared in D3dx9xof.h.