In This Topic ▼

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.

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

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, Linux.

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; 
}