cmMidiFile.h/c : In cmMIdiFileInsertTrack???() return the 'uid' of the new event record.

cmMidiFile.c

 
 }
 
-cmMfRC_t  cmMidiFileInsertTrackMsg( cmMidiFileH_t h, unsigned trkIdx, const cmMidiTrackMsg_t* msg )
+cmMfRC_t  cmMidiFileInsertTrackMsg( cmMidiFileH_t h, unsigned trkIdx, const cmMidiTrackMsg_t* msg, unsigned* uidRef )
 {
   _cmMidiFile_t* p = _cmMidiFileHandleToPtr(h);
 
+  if( uidRef != NULL )
+    *uidRef = cmInvalidId;
+
   // validate the track index
   if( trkIdx >= p->trkN )
     return cmErrMsg(&p->err,kInvalidTrkIndexMfRC,"The track index (%i) is invalid.",trkIdx);
     memcpy((void*)m->u.voidPtr,msg->u.voidPtr,msg->byteCnt);
   }
 
+  if( uidRef != NULL )
+    *uidRef = m->uid;
+  
   cmMidiTrackMsg_t* m0 = NULL;                  // msg before insertion
   cmMidiTrackMsg_t* m1 = p->trkV[trkIdx].base;  // msg after insertion
 
 
   p->trkV[trkIdx].cnt += 1;  
   p->msgVDirtyFl = true;
+
+
   
   return kOkMfRC;
    
 }
 
-cmMfRC_t  cmMidiFileInsertTrackChMsg( cmMidiFileH_t h, unsigned trkIdx, unsigned atick, cmMidiByte_t status, cmMidiByte_t d0, cmMidiByte_t d1 )
+cmMfRC_t  cmMidiFileInsertTrackChMsg( cmMidiFileH_t h, unsigned trkIdx, unsigned atick, cmMidiByte_t status, cmMidiByte_t d0, cmMidiByte_t d1, unsigned* uidRef )
 {
   cmMidiTrackMsg_t m;
   cmMidiChMsg_t   cm;
 
   assert( m.status >= kNoteOffMdId && m.status <= kPbendMdId );
   
-  return cmMidiFileInsertTrackMsg(h,trkIdx,&m);
+  return cmMidiFileInsertTrackMsg(h,trkIdx,&m,uidRef);
 }
 
-cmMfRC_t  cmMidFileInsertTrackTempoMsg( cmMidiFileH_t h, unsigned trkIdx, unsigned atick, unsigned bpm )
+cmMfRC_t  cmMidFileInsertTrackTempoMsg( cmMidiFileH_t h, unsigned trkIdx, unsigned atick, unsigned bpm, unsigned* uidRef )
 {
   cmMidiTrackMsg_t m;
 
   m.metaId     = kTempoMdId;
   m.u.iVal     = 60000000/bpm;  // convert BPM to microsPerQN
   
-  return cmMidiFileInsertTrackMsg(h,trkIdx,&m);
+  return cmMidiFileInsertTrackMsg(h,trkIdx,&m,uidRef);
 }
 
 

cmMidiFile.h

   //   byteCnt  - used to allocate storage for the data element in 'cmMidiTrackMsg_t.u'
   //   u        - the message data
   //
-  cmMfRC_t             cmMidiFileInsertTrackMsg(     cmMidiFileH_t h, unsigned trkIdx, const cmMidiTrackMsg_t* msg );
-  cmMfRC_t             cmMidiFileInsertTrackChMsg(   cmMidiFileH_t h, unsigned trkIdx, unsigned atick, cmMidiByte_t status, cmMidiByte_t d0, cmMidiByte_t d1 );
-  cmMfRC_t             cmMidFileInsertTrackTempoMsg( cmMidiFileH_t h, unsigned trkIdx, unsigned atick, unsigned bpm );
+  cmMfRC_t             cmMidiFileInsertTrackMsg(     cmMidiFileH_t h, unsigned trkIdx, const cmMidiTrackMsg_t* msg, unsigned* uidRef );
+  cmMfRC_t             cmMidiFileInsertTrackChMsg(   cmMidiFileH_t h, unsigned trkIdx, unsigned atick, cmMidiByte_t status, cmMidiByte_t d0, cmMidiByte_t d1, unsigned* uidRef );
+  cmMfRC_t             cmMidFileInsertTrackTempoMsg( cmMidiFileH_t h, unsigned trkIdx, unsigned atick, unsigned bpm, unsigned* uidRef );
   
   // Return a pointer to the first msg at or after 'usecsOffs' or kInvalidIdx if no
   // msg exists after 'usecsOffs'.  Note that 'usecOffs' is an offset from the beginning