LDicomDS::GetInfoDS

#include "Ltdic.h"

L_VOID LDicomDS::GetInfoDS(pnClass, pnFlags)

L_UINT32 *pnClass;

/* pointer to an IOD Class constant */

L_UINT16 *pnFlags;

/* flags that indicate file characteristics */

Gets information about the file.

Parameter

Description

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

See Also

Functions:

LDicomDS::GetPreamble, LDicomDS::GetCountValue

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 LDicomDS_GetInfoDSExample()
{
   L_INT      nRet;
   LDicomDS  *pDS;
   pDICOMIOD  pIOD;
   L_UINT32   nClass;
   L_UINT16   nFlags;
   L_TCHAR     szUnknown[]=TEXT("Unknown");
   L_TCHAR    *p;
   pDS = new LDicomDS(NULL);
   nRet = pDS->LoadDS(TEXT("%UserProfile%\\My Documents\\LEADTOOLS Images\\image1.dic"), 0);
   if(nRet != DICOM_SUCCESS)
      return nRet;
   pDS->GetInfoDS(&nClass, &nFlags);
   pIOD = LDicomIOD::FindClass(nClass);
   if (pIOD != NULL)
   {
      p = pIOD->pszName;
   }
   else
   {
      p = szUnknown;
   }
   MessageBox(NULL, p, TEXT("Notice"), MB_OK);
   delete pDS;
   return DICOM_SUCCESS;
}