Difference between revisions of "Truxton get device id"

From truxwiki.com
Jump to navigation Jump to search
 
(3 intermediate revisions by the same user not shown)
Line 3: Line 3:
 
=Syntax=
 
=Syntax=
 
<source lang="C">
 
<source lang="C">
void truxton_get_device_id( uint64_t trutxon_handle, char * destination_string, size_t max_size );
+
void truxton_get_device_id( uint64_t truxton_handle, char * destination_string, size_t max_size );
 
</source>
 
</source>
  
Line 28: Line 28:
 
=Sample=
 
=Sample=
 
<source lang="C" highlight="9">
 
<source lang="C" highlight="9">
void main()
+
void main( void )
 
{
 
{
 
     char id[256];
 
     char id[256];
Line 36: Line 36:
 
     uint64_t truxton = truxton_create();
 
     uint64_t truxton = truxton_create();
  
     truxton_get_device_id(truxton, id, sizeof(id));
+
     truxton_get_device_id( truxton, id, sizeof(id) );
  
     printf("%s\n", id);
+
     printf( "%s\n", id );
  
     truxton_destroy(truxton);
+
     truxton_destroy( truxton );
  
 
     truxton_stop();
 
     truxton_stop();
 
}
 
}
 
</source>
 
</source>

Latest revision as of 10:53, 3 February 2024

Retrieves the identifier of the hardware Truxton is running on.

Syntax

void truxton_get_device_id( uint64_t truxton_handle, char * destination_string, size_t max_size );

Parameters

truxton_handle

The handle created by the truxton_create call.

destination_string

The string to be written to.

max_size

The maximum number of characters that can be written to destination_string

Remarks

A device ID in Truxton is a GUID that uniquely identifies the hardware. The source of this identifier is the BIOS of the computer running your program. It can be retrieved using wmic using these parameters:

wmic path Win32_ComputerSystemProduct get UUID

This identifier is also written to the bios_id field of the header of a Depot File.

Sample

void main( void )
{
    char id[256];

    truxton_start();

    uint64_t truxton = truxton_create();

    truxton_get_device_id( truxton, id, sizeof(id) );

    printf( "%s\n", id );

    truxton_destroy( truxton );

    truxton_stop();
}