Programmer's Guide

RaDeKL Radar API Programmer’s Guide 25
© Multispectral Solutions, Inc. 2006
RaDeKL_GetInterval
Get the automatic detection interval for continuous detection mode in milliseconds.
NOTE: There are currently 5 distinct interval settings (see table below), but the actual range of
permissible settings should be obtained by calling RaDeKL_GetDeviceInfo and using interval_min
and interval_max, as these might change with future versions of the radar unit.
Format:
ULONG RaDeKL_GetInterval (RaDeKL_HANDLE handle, BYTE *interval);
Parameters:
handle RaDeKL_HANDLE as returned by a call to RaDeKL_OpenRadar.
interval Pointer to a BYTE to receive the interval value. Possible interval values are:
Symbolic Constant Duration Value
INTERVAL_1_SEC 1 second 0
INTERVAL_500_MSEC 500 milliseconds 1
INTERVAL_250_MSEC 250 milliseconds 2
INTERVAL_100_MSEC 100 milliseconds 3
INTERVAL_50_MSEC (default) 50 milliseconds 4
Return Value:
RADEKL_OK (0) if successful, a non-zero status otherwise. See RaDeKL_GetStatusText for codes.
Example:
Read the continuous detection interval and display its value.
ULONG status;
RaDeKL_HANDLE handle;
BYTE interval;
// Assume we have an open radar with a valid handle
status = RaDeKL_GetInterval (handle, &interval);
// Check status . . .
printf (“The interval for continuous detection is currently set to “);
switch (interval)
{
case INTERVAL_1_SEC: printf (“1 second\n”); break;
case INTERVAL_500_MS: printf (“500 ms\n”); break;
case INTERVAL_250_MS: printf (“250 ms\n”); break;
case INTERVAL_100_MS: printf (“100 ms\n”); break;
case INTERVAL_50_MS: printf (“50 ms\n”); break;
}