In This Topic ▼

LDicomWaveformChannel::GetChannelSamples

Summary

Gets the samples (data) for a waveform channel.

Syntax

#include "Ltdic.h"

L_INT32* LDicomWaveformChannel::GetChannelSamples(puNumberOfSamples)

Parameters

L_UINT32* puNumberOfSamples

Pointer to a variable to be updated with the number of samples for the channel.

Returns

Value	Meaning
!NULL	Pointer to a buffer that holds the channel samples.
NULL	Channel has no samples set.

Comments

This function returns a pointer to a buffer that holds the channel samples (data). If puNumberOfSamples is not NULL then it gets updated with the number of samples for the channel.

NOTE: The data is always encapsulated as 32-bit regardless of the bits allocated for the channel (8- or 16-bit). You can tell if the data for the channel is 8- or 16-bit from the waveform sample interpretation. For 8-bit channels the "Waveform Sample Interpretation" (5400,1006) can either be signed 8-bit linear (DICOM_SAMPLE_INTERPRETATION_SB), unsigned 8-bit linear (DICOM_SAMPLE_INTERPRETATION_UB), 8-bit mu-law (DICOM_SAMPLE_INTERPRETATION_MB) or 8-bit A-law(DICOM_SAMPLE_INTERPRETATION_AB). For 16-bit channels the "Waveform Sample Interpretation" can either be signed 16-bit linear (DICOM_SAMPLE_INTERPRETATION_SS) or unsigned 16-bit linear (DICOM_SAMPLE_INTERPRETATION_US). Use the LDicomWaveformGroup::GetSampleInterpretation function to get the waveform sample interpretation.

NOTE: This function returns a pointer to an internal buffer that is managed by the class. Therefore, you should not free it when you are done with it.