ID3DXSaveUserData::AddTopLevelDataObjectsPre

Add a top level object before the frame hierarchy.

HRESULT AddTopLevelDataObjectsPre(
  LPD3DXFILESAVEOBJECT pXofSave
);

Parameters

pXofSave

[in] Pointer to a .x file save object. Use this pointer to call IDirectXFileSaveObject::CreateDataObject to create the data object to be saved. Then call IDirectXFileSaveObject::SaveData to save the data.

Return Values

The return values of this method are implemented by an application programmer. In general, if no error occurs, program the method to return D3D_OK. Otherwise, program the method to return an appropriate error message from D3DERR or D3DXERR, as this will cause D3DXLoadMeshHierarchyFromX to fail also, and return the error.

Requirements

Header: Declared in D3dx9anim.h.