In This Topic ▼

L_DicomChannelSetNumber

Summary

Sets the channel number.

Syntax

#include "Ltdic.h"

L_LTDIC_API L_BOOL L_DicomChannelSetNumber(hDICOMWaveFormChannel, bInclude, nChannelNumber)

Parameters

HDICOMWAVEFORMCHANNEL hDICOMWaveFormChannel

A DICOM waveform channel handle

L_BOOL bInclude

Boolean flag that specifies whether the function should insert the "Waveform Channel Number" (003A,0202) element or remove it from the DICOM dataset. Possible values are:

Value	Meaning
TRUE	Insert the Waveform Channel Number (003A, 0202) element (that corresponds to this channel) into the dataset and then set its value.
FALSE	Delete the Waveform Channel Number (003A,0202) element (that corresponds to this channel) from the dataset.

L_INT32 nChannelNumber

New waveform channel number

Returns

Value	Meaning
TRUE	The waveform channel number was updated successfully.
FALSE	An error occurred.

Comments

This function sets the value of the "Waveform Channel Number" (003A,0202) element that corresponds to this channel. Set bInclude to TRUE to force the function to insert the element if it does not already exist in the dataset.

This function can also be used to delete the "Waveform Channel Number" (003A,0202) element that corresponds to this channel by setting bInclude to FALSE. In this case the nChannelNumber parameter is ignored.