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

Developer

API Reference

ITRIG_REFERENCETRIGLET()

Brew Release
Brew MP 1.0.2
See Also
None
Description
As for ITRIG_AcceptTriglet() except that the Trig does not take ownership of the supplied Triglet. Instead a reference to the supplied Triglet is made.
The caller is therefore responsible for the lifecycle of the supplied resource. Trigplayer will not delete it.
If ITRIG_ReferenceTriglet() is used to supply a Triglet with an ID (defined in the Triglet resource) that is already present in the Trig, then the existing Triglet will be released before the new Triglet is inserted. The method of release of the existing Triglet depends on whether it was supplied using ITRIG_AcceptTriglet() or ITRIG_ReferenceTriglet(). Only if the original resource was supplied using ITRIG_AcceptTriglet will it be deleted.
Params
node
[]:
[in] Pointer to the ITrig interface object
path
[]:
[in] Path in the filesystem to the triglet the caller wishes to have accepted (by reference) into the list of active resource files.
Interface
  • ITRIG
Prototype
  •    int ReferenceTriglet (ITrig* node, const char* path);
    
Return
  •    SUCCESS            - The triglet was accepted and the contained Resource file
                            was successfully added to the path list
       EVERSIONNOTSUPPORT - The supplied resource file had a version
                            that was not supported by this Trig        
       EFAILED            - The supplied triglet was unacceptable in some fashion
    
Side Effect
  • None
Comments
None