L_DicomGetInfoDS

#include "Ltdic.h"

L_LTDIC_API L_VOID L_DicomGetInfoDS(hDS, pnClass, pnFlags)

HDICOMDS hDS;

a DICOM handle

L_UINT32 * pnClass;

pointer to an IOD Class constant

L_UINT16 * pnFlags;

flags that indicate file characteristics

Gets information about the file.

Parameter Description
hDS A DICOM handle.
pnClass Pointer to an IOD Class constant which determines the class of information stored in the file. For a list of default IOD Module Constants, refer to IOD Module Constants.
pnFlags Meta-header flags and Transfer Syntax flags that indicate file characteristics. Possible values for the Meta-header flags are:
  Value Meaning
  DS_METAHEADER_PRESENT [0x0001] The header is present.
  DS_METAHEADER_ABSENT [0x0002] The header is absent.
  Possible values and combinations for the Transfer Syntax flags are:
  DS_LITTLE_ENDIAN [0x0004] Byte order is Little Endian.
  DS_BIG_ENDIAN [0x0008] Byte order is Big Endian.
  DS_IMPLICIT_VR [0x0010] The Value Representation is implicit.
  DS_EXPLICIT_VR [0x0020] The Value Representation is explicit.
  DS_LITTLE_ENDIAN | DS_IMPLICIT_VR
  DS_LITTLE_ENDIAN | DS_EXPLICIT_VR
  DS_BIG_ENDIAN | DS_EXPLICIT_VR

Any of the available Meta-header flags given above may be combined with any of the available values or combinations of values for the Transfer Syntax flags given above. For example, you may combine DS_METAHEADER_ABSENT with DS_EXPLICIT_VR, or you may combine DS_METAHEADER_PRESENT with DS_BIG_ENDIAN | DS_EXPLICIT_VR, etc.

Returns

None.

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.

See Also

Functions:

L_DicomGetPreamble, L_DicomGetCountValue

Topics:

Working with Data Sets

 

How to Disable the Automatic Loading of the default DICOM IOD Table

Example

This example displays the Data Set information

#define MAKE_IMAGE_PATH(pFileName) TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\")pFileName 
L_LTDICTEX_API L_INT DicomGetInfoDSExample(L_VOID) 
{ 
   HDICOMDS   hDS; 
   pDICOMIOD  pIOD; 
   L_UINT32   nClass; 
   L_UINT16   nFlags; 
   L_TCHAR     szUnknown[]=TEXT("Unknown"); 
   L_TCHAR    *p; 
   L_UINT16 nRet; 
   hDS = L_DicomCreateDS(NULL); 
   nRet = L_DicomLoadDS(hDS, MAKE_IMAGE_PATH(TEXT("Image1.dcm")), 0); 
   if (nRet != DICOM_SUCCESS) 
   { 
      L_DicomFreeDS(hDS); 
      return nRet; 
   } 
   L_DicomGetInfoDS(hDS, &nClass, &nFlags); 
   pIOD = L_DicomFindClassIOD(nClass); 
   if (pIOD != NULL) 
   { 
      p = pIOD->pszName; 
   } 
   else 
   { 
      p = szUnknown; 
   } 
   MessageBox(NULL, p, TEXT("Notice"), MB_OK); 
   L_DicomFreeDS(hDS); 
   return DICOM_SUCCESS; 
} 

Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS DICOM C API Help
Click or drag to resize