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

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

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, TEXT("%UserProfile%\\My Documents\\LEADTOOLS Images\\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;
}