View source for Truxton message set queue is empty

Tells the receiver that their message queue is empty.

=Syntax=
<source lang="C">
void truxton_message_set_queue_is_empty( uint64_t message_handle, uint32_t value );
</source>

=Parameters=
==<code>message_handle</code>==
The handle to a message created by the [[truxton_message_create]] call.

==<code>value</code>==
A non-zero value signifies that the message queue is empty.

=Remarks=
It should be noted that setting this property has no affect when sending the message to a message queue via the <code>[[truxton_route_message]]()</code> call.
This field is set by Truxton when it retrieves a message from the queue.

=Sample=
<source lang="C" highlight="7">
void test_message( uint64_t truxton )
{
   uint64_t message = truxton_message_create();

   truxton_message_set_truxton( message, truxton );

   truxton_message_set_queue_is_empty( message, 1 );

   int return_value = handle_message( message );

   if ( return_value == 0 )
   {
      printf( "Failed to handle an empty-queue message.\n" );
   }

   truxton_message_destroy( message );
}
</source>