d3d9.dllAddDataObject
Microsoft DirectX 9.0 SDK Update (October 2004)

ID3DXFileSaveObject::AddDataObject Method


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

Syntax

HRESULT AddDataObject(      

    REFGUID rguidTemplate,     LPCSTR szName,     const GUID *pId,     SIZE_T cbSize,     LPCVOID pvData,     ID3DXFileSaveData **ppObj );

Parameters

rguidTemplate
[in] Globally unique identifier (GUID) representing the data object's template.
szName
[in] Pointer to the name of the data object. Specify NULL if the object does not have a name.
pId
[in] Pointer to a GUID representing the data object. 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 Value

If the method succeeds, the return value is S_OK.

If the method fails, the return value can be one of the following:

D3DXFERR_BADOBJECTData could not be read from or written to an object.
DXFILEERR_BADVALUEParameter is invalid.
E_OUTOFMEMORYMicrosoft Direct3D could not allocate sufficient memory to complete the call.


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.

See Also

ID3DXFileSaveObject::Save


© 2004 Microsoft Corporation. All rights reserved.
Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center.