L_DicomChannelGetSensitivity

#include "Ltdic.h"

L_LTDIC_API L_UINT16 L_DicomChannelGetSensitivity(hDICOMWaveFormChannel, pbIncluded, pdChannelSensitivity, pChannelSensitivityUnits, uStructSize, pdChannelSensitivityCF, pdChannelBaseline)

HDICOMWAVEFORMCHANNEL hDICOMWaveFormChannel;

/* a DICOM waveform channel handle*/

L_BOOL * pbIncluded;

/* pointer to a variable to be updated*/

L_DOUBLE * pdChannelSensitivity;

/* pointer to a variable to be updated*/

pDICOMCODESEQUENCEITEM pChannelSensitivityUnits;

/* pointer to a variable to be updated*/

L_UINT uStructSize;

/* size of a structure */

L_DOUBLE * pdChannelSensitivityCF;

/* pointer to a variable to be updated*/

L_DOUBLE * pdChannelBaseline;

/* pointer to a variable to be updated*/

Gets the channel sensitivity.

Parameter

Description

hDICOMWaveFormChannel

A DICOM waveform channel handle

pbIncluded

Pointer to a flag that indicates whether the channel sensitivity is set for this channel. Possible values are:

 

Value

Meaning

 

TRUE

The channel sensitivity is set for this channel.

 

FALSE

The channel sensitivity is not set for this channel.

pdChannelSensitivity

Pointer to a variable that will be updated with the channel sensitivity. For more information, refer to the Channel Sensitivity (003A,0210) element in the DICOM standard.

pChannelSensitivityUnits

Pointer to a DICOMCODESEQUENCEITEM structure to be updated with the channel sensitivity units. For more information, refer to the "Channel Sensitivity Units Sequence" (003A,0211) element in the DICOM standard.

uStructSize

Size of the DICOMCODESEQUENCEITEM structure. Pass sizeof (DICOMCODESEQUENCEITEM).

pdChannelSensitivityCF

Pointer to a variable that will be updated with the channel sensitivity correction factor. For more information, to the "Channel Sensitivity Correction Factor" (003A,0212) element in the DICOM standard.

pdChannelBaseline

Pointer to a variable that will be updated with the channel baseline. For more information, refer to the "Channel Baseline" (003A,0213) element in the DICOM standard.

Returns

0

The function was successful.

> 0

An error occurred. Refer to Return Codes.

 

Comments

Use this function to get the values for all the elements related to the channel sensitivity.

This function fails and returns DICOM_ERROR_NULL_PTR if pdChannelSensitivity is NULL.

The pChannelSensitivityUnits parameter points to a structure that can be filled using the functions offered by the context groups functions (L_DicomxxxContextGroup and L_DicomxxxCodedConcept) . For more information about these functions and the use of Coded Concepts in DICOM, please refer to Working with Context Groups.

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:

L_DicomChannelSetSensitivity

Topics:

Working with DICOM Waveforms

 

 

Example

For an example, refer to L_DicomChannelSetSamples8.