Collapse All Expand All

L_DicomWaveGrpGetChannel

#include "Ltdic.h"

L_LTDIC_API HDICOMWAVEFORMCHANNEL L_DicomWaveGrpGetChannel(hDICOMWaveFormGroup, uIndex)

HDICOMWAVEFORMGROUP hDICOMWaveFormGroup;	/* a DICOM waveform group handle */
L_UINT32 uIndex;	/* index */

Gets a channel from the waveform group.

Parameter	Description
hDICOMWaveFormGroup	A DICOM waveform group handle
uIndex	Zero-based index of the channel to retrieve. As an example, if you want to retrieve the 10th channel, use an index of 9.

Returns

!NULL	The function was successful.
NULL	An error occurred.

Comments

A waveform in DICOM consists of one or more multiplex groups, each encoded into an item in the "Waveform Sequence" (5400,0100). All channels within a multiplex group are synchronously digitized at a common sampling frequency. Use this function to retrieve the specified channel under the waveform group.

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

This function returns NULL if the index is out of range or if this waveform group does not have any channels associated with it.

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, Linux.

See Also

Functions:	L_DicomWaveGrpGetNumberOfChannels, L_DicomWaveGrpAddChannel, L_DicomWaveGrpDeleteChannel, L_DicomChannelGetWaveformGroup, L_DicomChannelGetIndex
Topics:	Working with DICOM Waveforms

Example

For an example, refer to L_DicomChannelSetSamples8.