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

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.