Developer

API Reference

ITRIG_ReferenceTriglet()

deprecated
Items marked as deprecated have been replaced by a more powerful, alternative feature. Deprecated interfaces include a reference to the replacement interface, which should be used for all new application development. Deprecated features are still supported for backward compatibility, but should be avoided when developing new applications.
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.
Parameters
  • 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
Comment
None
  • Follow