L_DicomChannelGetAnnotation

#include "Ltdic.h"

L_LTDIC_API pDICOMWAVEFORMANNOTATION L_DicomChannelGetAnnotation(hDICOMWaveFormChannel, uIndex)

HDICOMWAVEFORMCHANNEL hDICOMWaveFormChannel;

/* a DICOM waveform channel handle*/

L_UINT32 uIndex;

/* index */

Gets the channel annotation.

Parameter

Description

hDICOMWaveFormChannel

A DICOM waveform channel handle

uIndex

Index to the waveform annotation to be retrieved. This index is zero-based. As an example, if you are retrieving the 3rd waveform annotation, use an index of 2.

Returns

!NULL

A pointer to a DICOMWAVEFORMANNOTATION structure that describes one of waveform annotations associated with this channel.

NULL

An error occurred.

Comments

This function returns a pointer to a DICOMWAVEFORMANNOTATION structure that describes one of waveform annotations associated with this channel.

This function returns NULL if the index is out of range or if the channel has no annotations associated with it.

Note: This function returns a pointer to an internal structure that is managed by the toolkit. Therefore, you should not free it when you are done 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_DicomChannelGetAnnotationCount, L_DicomChannelAddAnnotation, L_DicomChannelDeleteAnnotation

Topics:

Working with DICOM Waveforms

Example

For an example, refer to L_DicomChannelSetSamples8.