Difference between revisions of "Truxton media get description"

From truxwiki.com
Jump to navigation Jump to search
Line 3: Line 3:
  
 
=Syntax=
 
=Syntax=
<syntaxhighlight lang="C">
+
<source lang="C">
 
void truxton_media_get_description( uint64_t media_handle, char * destination_string, size_t max_size );
 
void truxton_media_get_description( uint64_t media_handle, char * destination_string, size_t max_size );
</syntaxhighlight>
+
</source>
  
 
=Parameters=
 
=Parameters=
Line 18: Line 18:
  
 
=Sample=
 
=Sample=
<syntaxhighlight lang="C" highlight="12">
+
<source lang="C" highlight="12">
void print_description(uint64_t truxton)
+
void print_description( uint64_t truxton )
 
{
 
{
   uint64_t media = truxton_media_open_id(truxton, "150929ce-bf30-4d5d-08d9-b48a0806c843");
+
   uint64_t media = truxton_media_open_id( truxton, "150929ce-bf30-4d5d-08d9-b48a0806c843" );
  
 
   if ( media != 0 )
 
   if ( media != 0 )
Line 30: Line 30:
 
   char description[ MAX_PATH ];
 
   char description[ MAX_PATH ];
  
   truxton_media_get_description(media, description, sizeof(description));
+
   truxton_media_get_description( media, description, sizeof(description) );
  
   printf( "Description is %s\n", description);
+
   printf( "Description is %s\n", description );
  
   truxton_media_free(media);
+
   truxton_media_free( media );
 
}
 
}
</syntaxhighlight>
+
</source>

Revision as of 23:41, 9 February 2021

This retrieves the description of the media. It corresponds to the [Description] column of the [Media] table.

Syntax

void truxton_media_get_description( uint64_t media_handle, char * destination_string, size_t max_size );

Parameters

media_handle

The handle created by the truxton_media_create or truxton_media_open_id call.

destination_string

The string to be written to.

max_size

The maximum number of characters that can be written to destination_string.

Sample

void print_description( uint64_t truxton )
{
   uint64_t media = truxton_media_open_id( truxton, "150929ce-bf30-4d5d-08d9-b48a0806c843" );

   if ( media != 0 )
   {
      return;
   }

   char description[ MAX_PATH ];

   truxton_media_get_description( media, description, sizeof(description) );

   printf( "Description is %s\n", description );

   truxton_media_free( media );
}