API Reference | developer.brewmp.com API Reference | developer.brewmp.com

Developer

API Reference

ITRIGMLELEMENT_GETATTRIBUTE()

Brew Release
Brew MP 1.0.2
See Also
ITRIGMLELEMENT_SetAttribute() ITRIGMLELEMENT_GetAttributeNoResolve() ITRIGMLELEMENT_GetIntAttribute() ITRIGMLELEMENT_GetStringAttribute()
Description
Resolves and returns the value of the given attribute on the given element.
Params
po
[]:
The element for which to get the attribute.
classId
[]:
The class ID of the attribute to get. This should be a KTrigml*ExtensionClassId constant from an extension metadata header.
id
[]:
The attribute ID of the attribute to get. This should be a KTrigml*Attr* constant from an extension metadata header.
ppValue
[]:
A pointer to receive the address of the resolved value of the attribute. The memory pointed to is owned by the Trigplayer; do not free it.
Interface
  • ITRIGMLELEMENT
Prototype
  •    int ITRIGMLELEMENT_GetAttribute(ITrigmlElement* po, AEECLSID classId, uint16 id, const TrigmlValue ** ppValue);
    
Return
  •    If the attribute exists on the element and its value was successfully
       resolved, the function will return SUCCESS and *ppValue will point to the
       resolved value of the attribute.
       If the attribute does not exist on the element, the function will return
       SUCCESS and *ppValue will be NULL.
       If the attribute exists on the element but could not be resolved, the
       function will return an appropriate non-SUCCESS error code.
    
Side Effect
  • Any observers of the attribute value will be notified with the new resolved attribute value. Attribute resolution can therefore be an expensive operation. Do not call ITRIGMLELEMENT_GetAttribute more often than is necessary.
Comments
None