Programmer's Guide

RaDeKL Radar API Programmer’s Guide 31

RaDeKL_ReadDetectionData

Read and return the range bin data of a single detection in continuous mode. This function is intended to be

used in conjunction with RaDeKL_StartContinuousDetection and RaDeKL_StopContinuousDetection.

NOTE: The number of range bins is currently 256 with possible data values between 0 and 32, but

the actual number of range bins and the range of their possible values should be obtained by

calling RaDeKL_GetDeviceInfo and using range_bins, range_bin_min and range_bin_max, as they

might change with future versions of the radar unit.

Format:

ULONG RaDeKL_ReadDetectionData (RaDeKL_HANDLE handle, BYTE *data);

Parameters:

handle RaDeKL_HANDLE as returned by a call to RaDeKL_OpenRadar.

data Pointer to a BYTE array to receive the radar return data.

Note: This array is not null-terminated, since zeroes may appear in the data.

Note: the size of this array and the maximum value for each range bin are currently

fixed at 256 and 32, respectively, but might change with future versions. See notes

for RaDeKL_DetectSingle.

Return Value:

RADEKL_OK (0) if successful, a non-zero status otherwise. See RaDeKL_GetStatusText for codes.

Example:

See the examples for RaDeKL_StartContinuousDetection above.