GPMID_GetTrackName function

Print

Retrieves the name of a track embedded in the tablature which is currently loaded.

Syntax

Print

  1. GPMID_ENTRY const char* GPMID_GetTrackName(
  2. unsigned int aTrackIdx
  3. );

Parameters

  1. aTrackIdx

    The zero-based index of the track for which to retrieve the name.

Return value

The name of the track embedded in the tablature.

Remarks

Before using this function, GPMID must have been initialized with GPMID_Init and a tablature must have been successfully loaded with GPMID_Load. This function can be called with an index ranging from 0 to the value returned by GPMID_GetTrackCount minus 1. If the name of the corresponding track is not set, this function returns an empty string.