L_DicomChannelSetNumber

#include "Ltdic.h"

L_LTDIC_API L_BOOL L_DicomChannelSetNumber(hDICOMWaveFormChannel, bInclude, nChannelNumber)

HDICOMWAVEFORMCHANNEL hDICOMWaveFormChannel;

/* a DICOM waveform channel handle*/

L_BOOL bInclude;

/* dataset insertion/removal flag */

L_INT32 nChannelNumber;

/* new channel number*/

Sets the channel number.

Parameter

Description

hDICOMWaveFormChannel

A DICOM waveform channel handle

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.

nChannelNumber

New waveform channel number

Returns

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 doesnt 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.

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

Platforms

Win32, x64

See Also

Functions:

L_DicomChannelGetNumber

Topics:

Working with DICOM Waveforms

Example

For an example, refer to L_DicomChannelSetSamples8.