In This Topic ▼

LDicomWaveformChannel::GetChannelSensitivity

Summary

Gets the channel sensitivity.

Syntax

#include "Ltdic.h"

L_UINT16 LDicomWaveformChannel::GetChannelSensitivity(pbIncluded, pdChannelSensitivity, pChannelSensitivityUnits, uStructSize, pdChannelSensitivityCF, pdChannelBaseline)

Parameters

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

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
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 LDicomContextGroup class. For more information about this class and the use of Coded Concepts in DICOM, refer to Working with Context Groups.