L_DicomLoadDSMemory

#include "Ltdic.h"

L_LTDIC_API L_UINT16 L_DicomLoadDSMemory(hDS, pBuffer, uBufferSize, nFlags);

Loads a DICOM Data Set from memory.

Returns

Comments

You must call L_DicomCreateDS to allocate memory for the Data Set, prior to calling this function.

Unless you pass the DS_LOAD_CLOSE flag, this function DOES NOT make a copy of the memory pointed to by pBuffer. Therefore, DO NOT free this memory as long as you are using the dataset referenced by hDS, or until you have reset the dataset by calling L_DicomResetDS.

Once you have called L_DicomResetDS, you can repopulate the data set referenced by hDS by calling L_DicomInitDS, L_DicomLoadDS, or L_DicomLoadDSMemory. It is not necessary to call L_DicomCreateDS again before repopulating the data set.

If you know certain characteristics of the DICOM file in memory, you can set those in nFlags.  Any characteristic that you dont set will be automatically determined. For example, if you know that the metaheader is present, but you do not know the byte order, or whether the Value Representation is implicit or explicit, you can set only DS_METAHEADER_PRESENT in nFlags. During loading LEADTOOLS will determine the byte order and whether the byte order is implicit or explicit.

If you do not know any of the characteristics of the DICOM file in memory, set nFlags to 0 and LEADTOOLS will automatically determine all the file characteristics and load the file accordingly.

To load a data set from a file, call L_DicomLoadDS.

Required DLLs and Libraries

Platforms

Win32, x64

See Also

Example

#define MAKE_IMAGE_PATH(pFileName) TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\")pFileName
L_INT DicomLoadDSMemoryExample(L_VOID)
{
   HDICOMDS    hDS;
   HANDLE      hFile;   
   L_UCHAR*    pBuffer = NULL;
   L_UINT32    uBufferSize = 0;
   L_BOOL      bResult;
   L_UINT32    NumberOfBytesRead;
   L_UINT16    uDICOMRet;
   L_UINT32    nClass;
   L_UINT16    nFlags;
   L_TCHAR      szUnknown[]=TEXT("Unknown Class");
   L_TCHAR      *pClassName;
   pDICOMIOD   pIOD;
      
   //Create the dataset
   hDS = L_DicomCreateDS(NULL);
   if(hDS == NULL)
      return DICOM_ERROR_NULL_PTR;
   //Create a handle to the DICOM file on disk
   hFile = CreateFile(  MAKE_IMAGE_PATH(TEXT("Image2.dcm")),
                        GENERIC_READ,
                        FILE_SHARE_READ,
                        NULL,
                        OPEN_EXISTING,
                        FILE_ATTRIBUTE_NORMAL,
                        NULL);
   if (hFile == INVALID_HANDLE_VALUE)
   {
      L_DicomFreeDS(hDS);
      return DICOM_ERROR_NULL_PTR;
   }
   //Get the file size
   uBufferSize = GetFileSize(hFile, NULL);
   if(uBufferSize == INVALID_FILE_SIZE)
   {
      CloseHandle(hFile);
      L_DicomFreeDS(hDS);
      return uBufferSize;
   }
   //Allocate a buffer that will hold the data in the file
   pBuffer = (L_UCHAR*) malloc(uBufferSize);
   if(pBuffer == NULL)
   {
      CloseHandle(hFile);
      L_DicomFreeDS(hDS);
      return DICOM_ERROR_NULL_PTR;
   }
   //Read the file data into a buffer
   bResult = ReadFile(hFile, pBuffer, uBufferSize, (LPDWORD)(&NumberOfBytesRead), NULL);    
   if(bResult == FALSE) 
   { 
      free(pBuffer);
      CloseHandle(hFile);
      L_DicomFreeDS(hDS);
      return FAILURE - 1;
   }
   //Load DICOM file from memory
   uDICOMRet = L_DicomLoadDSMemory(hDS, pBuffer, uBufferSize, 0);
   if(uDICOMRet != DICOM_SUCCESS)
   {
      free(pBuffer);
      CloseHandle(hFile);
      L_DicomFreeDS(hDS);
      return uDICOMRet;
   }
   //Get the information about the DICOM file.
   L_DicomGetInfoDS(hDS, &nClass, &nFlags);
   pIOD = L_DicomFindClassIOD(nClass);
   if (pIOD != NULL)
   {
      pClassName = pIOD->pszName;
   }
   else
   {
      pClassName = szUnknown;
   }
   MessageBox(NULL, pClassName, TEXT("Notice"), MB_OK);
   //Make sure to cleanup
   free(pBuffer);
   CloseHandle(hFile);
   L_DicomFreeDS(hDS);
   return DICOM_SUCCESS;
}