Truxton media get status

From truxwiki.com
Revision as of 07:52, 25 July 2020 by Sam (talk | contribs) (→‎Sample)
Jump to navigation Jump to search

This retrieves the status of the media. It corresponds to the MediaStatusID column of the Media table. It can be one of the defined constants but it must be one of the values in the ID column of the MediaStatus table.

Syntax

uint64_t truxton_media_get_status( uint64_t media_handle );

Parameters

media_handle

The handle created by the truxton_media_open_id or truxton_media_create call.

Return value

The status of the media.

Sample

void print_status(uint64_t media)
{
   uint64_t status = truxton_media_get_status( media );

   if ( status == MEDIA_STATUS_LOADED )
   {
      printf( "The media has finished loading.\n" );
   }
   else
   {
      printf( "The media is not done.\n" );
   }
}