LDicomDS::GetWaveformGroup

#include "Ltdic.h"

L_UINT16 LDicomDS::GetWaveformGroup(uIndex, pWaveformGroup)

L_UINT32 uIndex;

/* index*/

LDicomWaveformGroup* pWaveformGroup;

/* pointer to an object to be updated */

Gets a waveform group.

Parameter

Description

uIndex

Zero-based index of the group to be retrieved. As an example, if there are three waveform groups, use an index of 2 to retrieve the third group.

pWaveformGroup

Pointer to a class which holds the waveform group attributes and data.

Returns

0

The function was successful.

> 0

An error occurred. Refer to Return Codes.

Comments

In DICOM, a waveform consists of one or more multiplex groups, each encoded into an item in the "Waveform Sequence" (5400,0100). Use this function to extract the specified multiplex group.

This function populates the object pointed to by pWaveformGroup with the multiplex group attributes and for each channel in the group, adds a new channel by calling LDicomWaveformGroup::AddChannel.

This function fails and returns DICOM_ERROR_NULL_PTR if pWaveformGroup is NULL.

This is the main function for extracting waveforms from a DICOM dataset. Once pWaveformGroup is populated you can call the functions defined either by LDicomWaveformGroup or LDicomWaveformChannel, providing you comprehensive DICOM waveform support.

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

See Also

Functions:

LDicomDS::GetWaveformGroupCount, LDicomDS::DeleteWaveformGroup, LDicomDS::AddWaveformGroup, LDicomWaveformGroup class members, LDicomWaveformChannel class members

Topics:

Working with DICOM Waveforms

 

How to Disable the Automatic Loading of the default DICOM IOD Table

Example

For an example, refer to LDicomWaveformChannel::SetChannelSamples8