ID3DXFileSaveObject::AddDataObject method

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

Syntax

HRESULT AddDataObject(
  [in]               REFGUID           rguidTemplate,
  [in]               LPCSTR            szName,
  [in]         const GUID              *pId,
  [in]               SIZE_T            cbSize,
  [in]               LPCVOID           pvData,
  [in, retval]       ID3DXFileSaveData **ppObj
);

Parameters

rguidTemplate [in]

Type: REFGUID

GUID representing the data object's template.

szName [in]

Type: LPCSTR

Pointer to the name of the data object. Specify NULL if the object does not have a name.

pId [in]

Type: const GUID*

Pointer to a GUID representing the data object. Specify NULL if the object does not have a GUID.

cbSize [in]

Type: SIZE_T

Size of the data object, in bytes.

pvData [in]

Type: LPCVOID

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

ppObj [in, retval]

Type: ID3DXFileSaveData**

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

Return value

Type: HRESULT

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, DXFILEERR_BADVALUE, E_OUTOFMEMORY.

Remarks

If a data reference object will reference the data object, either the szName or pId parameter must be non-NULL.

Save the created data to disk by using the ID3DXFileSaveObject::Save method.

Requirements

Requirement Value
Header
D3DX9Xof.h
Library
D3dx9.lib

See also

ID3DXFileSaveObject