L_DicomFindIOD

Summary

Returns a pointer to an item in the IOD Structure that contains the IOD with the specified code and type.

Syntax

#include "Ltdic.h"

L_LTDIC_API pDICOMIOD L_DicomFindIOD(pIOD, nCode, nType, bTree)

Parameters

pDICOMIOD pIOD

Pointer to a DICOMIOD structure that contains an item in the IOD Structure. A pointer to the item in the IOD Structure that contains the IOD with the specified nCode and nType will be returned.

L_UINT32 nCode

Code value that specifies the Information Object Definition. The information object may be a Class, a Module or a Tag. For lists of default values, refer to Data Element Tag Constants, IOD Class Constants, and IOD Module Constants.

L_UCHAR nType

The type of Information Object Definition you are working with. Possible values are:

Value Meaning
IOD_TYPE_CLASS [0x00] Class type Information Object Definition.
IOD_TYPE_MODULE [0x01] Module type Information Object Definition.
IOD_TYPE_ELEMENT [0x02] Element type Information Object Definition.

L_BOOL bTree

Flag that indicates how the IOD Structure will be evaluated. Possible values are:

Value Meaning
TRUE Evaluate the IOD Structure as a tree.
FALSE Evaluate the IOD Structure as a list.

Returns

Value Meaning
!NULL A pointer to a DICOMIOD structure that contains the item in the IOD Structure of the specified code and type.
NULL An item with the specified code and type was not found.

Comments

The nCode and nType parameters must correspond. For example, if you specify IOD_TYPE_CLASS in nType, you must specify a value from the IOD Class Constants in nCode. If you specify some other value, the item will not be found in the IOD Structure.

Required DLLs and Libraries

Platforms

Win32, x64, Linux.

See Also

Functions

Topics

Example

This example displays the name of an item

L_INT DicomFindIODExample(L_VOID) 
{ 
   pDICOMIOD pIOD; 
 
   pIOD = L_DicomFindIOD(NULL, TAG_PATIENT_NAME, IOD_TYPE_ELEMENT, FALSE); 
   if (pIOD != NULL) 
      MessageBox(NULL, pIOD->pszName, TEXT("Notice"), MB_OK); 
 
   return DICOM_SUCCESS; 
} 

Help Version 22.0.2022.12.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.