Truxton media add child - Revision history

Sam: /* Sample */

2026-02-05T11:04:37Z

Sample

Sam at 10:48, 10 February 2021

2021-02-10T10:48:20Z

Sam at 08:13, 5 December 2020

2020-12-05T08:13:07Z

Sam: Created page with "This creates a new child file belonging to this media. This new child will be an orphan. You must set the Truxton_child_file_set_parent_id|pare..."

2020-07-26T12:40:48Z

Created page with "This creates a new child file belonging to this media. This new child will be an orphan. You must set the Truxton_child_file_set_parent_id|pare..."

New page

This creates a new [[Truxton C API#Child Files|child file]] belonging to this media.
This new child will be an orphan.
You must set the [[Truxton_child_file_set_parent_id|parent file id]] in order to have it show up in the file hierarchy.

=Syntax=
<syntaxhighlight lang="C">
uint64_t truxton_media_add_child( uint64_t media_handle );
</syntaxhighlight>

=Parameters=
==<code>media_handle</code>==
The handle created by the [[truxton_media_open_id]] or [[truxton_media_create]] call.

=Return value=
The handle to a new orphaned [[Truxton C API#Child Files|child file]] object belonging to this media.

=Sample=
<syntaxhighlight lang="C" highlight="9">
uint64_t make_new_generated_file(uint64_t media)
{
char guid_string[ 40 ];

truxton_media_get_generated_files_folder_id( media, guid_string, sizeof(guid_string));

uint64_t child_file = truxton_media_add_child( media )

truxton_child_file_set_parent_id( child_file, guid_string );

return( child_file );
}
</syntaxhighlight>

@@ Line 16: / Line 16: @@
 =Sample=
-<source lang="C" highlight="9">
+<source lang="C" highlight="7">
 uint64_t make_new_generated_file( uint64_t media )
+{

@@ Line 17: / Line 17: @@
 =Sample=
 <source lang="C" highlight="9">
-uint64_t make_new_generated_file(uint64_t media)
+uint64_t make_new_generated_file( uint64_t media )
+{
     char guid_string[ 40 ];
-    truxton_media_get_generated_files_folder_id( media, guid_string, sizeof(guid_string));
+    truxton_media_get_generated_files_folder_id( media, guid_string, sizeof(guid_string) );
     uint64_t child_file = truxton_media_add_child( media )

@@ Line 4: / Line 4: @@
 =Syntax=
-<syntaxhighlight lang="C">
+<source lang="C">
 uint64_t truxton_media_add_child( uint64_t media_handle );
-</syntaxhighlight>
+</source>
 =Parameters=
@@ Line 16: / Line 16: @@
 =Sample=
-<syntaxhighlight lang="C" highlight="9">
+<source lang="C" highlight="9">
 uint64_t make_new_generated_file(uint64_t media)
+{
@@ Line 29: / Line 29: @@
     return( child_file );
+}
-</syntaxhighlight>
+</source>