View source for r7.1.0:Enum lfds710 queue bmm query

{{DISPLAYTITLE:enum lfds710_queue_bmm_query}}
==Source File==
 └───liblfds710
     └───inc
         └───liblfds710
                 lfds710_queue_bmm.h

==Enum==
 enum lfds710_queue_umm_query
 {
   LFDS710_QUEUE_BMM_QUERY_GET_POTENTIALLY_INACCURATE_COUNT,
   LFDS710_QUEUE_BMM_QUERY_SINGLETHREADED_VALIDATE
 };

==Values==
''LFDS710_QUEUE_BMM_QUERY_GET_POTENTIALLY_INACCURATE_COUNT''
: Counts the number of elements in the queue.  Where with this queue, enqueue and dequeue operations are not guaranteed to be visible by the time the enqueue or dequeue function returns, it must then be that the count of operations can be inaccurate.  If some (typically) tens of microseconds have passed since the last operation by any thread, the count will be correct.
''LFDS710_QUEUE_UMM_QUERY_SINGLETHREADED_VALIDATE''
: Validates the queue.  Additionally, if given as input a ''[[r7.1.0:struct lfds710_misc_validation_info|lfds710_misc_validation_info]]'', which indicates an expected range of the number of elements in the queue, counts the number of elements in the queue and checks they fall within the expected range.  As with count, both the loop check and the element count (which is in fact performed by issuing the ''LFDS710_QUEUE_UMM_QUERY_SINGLETHREADED_GET_COUNT'' query) can in theory enter an infinite loop if enqueue or dequeue operations occur while the validation operation is executing.  You were warned.

==Notes==
This enum is used by the queue query function, ''[[r7.1.0:function lfds710_queue_bmm_query|lfds710_queue_bmm_query]]''.

==See Also==
* [[r7.1.0:Queue (bounded, many producer, many consumer)|Queue (bounded, many producer, many consumer)]]