Difference between revisions of "Truxton media get status"

From truxwiki.com
Jump to navigation Jump to search
Line 16: Line 16:
  
 
=Sample=
 
=Sample=
<syntaxhighlight lang="C" line highlight="3">
+
<syntaxhighlight lang="C" highlight="3">
 
void print_status(uint64_t media)
 
void print_status(uint64_t media)
 
{
 
{

Revision as of 07:52, 25 July 2020

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" );
   }
}