In This Topic ▼

L_DicomWaveGrpSetNumberOfSamplesPerChannel

Summary

Sets the number of samples per channel.

Syntax

#include "Ltdic.h"

L_LTDIC_API L_BOOL L_DicomWaveGrpSetNumberOfSamplesPerChannel(hDICOMWaveFormGroup, uNumberOfSamples)

Parameters

HDICOMWAVEFORMGROUP hDICOMWaveFormGroup

A DICOM waveform group handle.

L_UINT32 uNumberOfSamples

New number of samples for a channel included in this waveform group.

Returns

Value	Meaning
TRUE	The number of samples per channel was set successfully.
FALSE	An error occurred.

Comments

In DICOM all channels within a multiplex group are synchronously digitized at a common sampling frequency and have the same number of samples. Use this function to set the number of samples per channel in this group.

The initial value for the number of samples per channel is zero.

Make sure to call this function before you call any functions that are used to set the data for a channel that is included in the waveform group. The functions that are used to set the data for a channel include L_DicomChannelSetSamples8, L_DicomChannelSetSamples16 and L_DicomChannelSetSamples32.

If you call this function after setting the data for one or more channels that are included in this group, then the function will expand or shrink the internal buffers that hold the data for each of the channels accordingly. For example, if you initially call this function and pass it 150 as the number of samples per channel and then call L_DicomChannelSetSamples8 and set 150 samples for a channel that is included in the waveform group and then call this function again and pass it 125, then this will shrink the buffer that holds the data for the channel to be 125 samples long and will discard all the samples that do not fit in the buffer any more.