In This Topic ▼

L_DicomChannelGetSensitivity

Summary

Gets the channel sensitivity.

Syntax

#include "Ltdic.h"

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

Parameters

HDICOMWAVEFORMCHANNEL hDICOMWaveFormChannel

A DICOM waveform channel handle

L_BOOL * pbIncluded

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

TRUE
FALSE

L_DOUBLE * 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.

pDICOMCODESEQUENCEITEM 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.

L_UINT uStructSize

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

L_DOUBLE * 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.

L_DOUBLE * 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

Value	Meaning
DICOM_SUCCESS	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, refer to Working with Context Groups.