L_DicomGetWaveformGroup

#include "Ltdic.h"

L_UINT16 EXT_FUNCTION L_DicomGetWaveformGroup(hDS, uIndex, hDICOMWaveFormGroup)

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

Gets a waveform group.

Parameter	Description
hDS	A DICOM handle.
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.

hDICOMWaveFormGroup

A DICOM waveform group handle

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 waveform group referenced by hDICOMWaveFormGroup with the multiplex group attributes and for each channel in the group, adds a new channel by calling L_DicomWaveGrpAddChannel.

This function fails and returns DICOM_ERROR_NULL_PTR if hDICOMWaveFormGroup is NULL.

This is the main function for extracting waveforms from a DICOM dataset. Once this function returns and hDICOMWaveFormGroup is initialized, you can call the L_DicomWaveGrpxxx and the L_DicomChannelxxx functions, 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