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.

Example

This example displays the Data Set information

#define MAKE_IMAGE_PATH(pFileName) TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\")pFileName 
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; 
}

Help Version 19.0.2017.10.27

Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help

Introduction

Version History

Getting Started

Features of LEADTOOLS DICOM

Redistributables/Files To Be Included With Your Application

Functions:	L_DicomGetPreamble, L_DicomGetCountValue
Topics:	Working with Data Sets
	How to Disable the Automatic Loading of the default DICOM IOD Table