L_DicomWaveGrpSetSampleInterpretation

#include "Ltdic.h"

L_LTDIC_API L_BOOL L_DicomWaveGrpSetSampleInterpretation(hDICOMWaveFormGroup, uInterpretation)

HDICOMWAVEFORMGROUP hDICOMWaveFormGroup;	/* a DICOM waveform group handle*/
L_UINT16 uInterpretation;	/* new sample interpretation*/

Sets the waveform sample interpretation.

Parameter	Description
hDICOMWaveFormGroup	A DICOM waveform group handle
uInterpretation	The new waveform sample interpretation. Possible values are:
	Value	Meaning
	DICOM_SAMPLE_INTERPRETATION_SS	[0x00] signed 16-bit linear
	DICOM_SAMPLE_INTERPRETATION_US	[0x01] unsigned 16-bit linear
	DICOM_SAMPLE_INTERPRETATION_SB	[0x02] signed 8-bit linear
	DICOM_SAMPLE_INTERPRETATION_UB	[0x03] unsigned 8-bit linear
	DICOM_SAMPLE_INTERPRETATION_MB	[0x04] 8-bit mu-law
	DICOM_SAMPLE_INTERPRETATION_AB	[0x05] 8-bit A-law

Returns

TRUE	The waveform sample interpretation 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 sample interpretation. Use this function to set the waveform sample interpretation, which applies to all channels in the waveform group.

For more information about sample interpretation refer to the "Waveform Sample Interpretation" (5400,1006) element in the DICOM standard.

The default value for sample interpretation is DICOM_SAMPLE_INTERPRETATION_SS.

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. Such functions 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 convert the data for each of the channels to match the new sample interpretation.

Required DLLs and Libraries

LTDIC

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application