Products | Support | Send comments on this topic. | Email a link to this topic. | Back to Getting Started | Help Version 18.0.10.23
LEADTOOLS DICOM C DLL Help

L_DicomGetPresStateImageRefBySOPInstance

Show in webframe

#include "l_bitmap.h"

L_LTDIC_API pDICOMELEMENT L_DicomGetPresStateImageRefBySOPInstance(hDS, pszSOPInstanceUID)

HDICOMDS hDS;

/* a DICOM handle */

L_TCHAR * pszSOPInstanceUID;

/* SOP Instance UID of the image */

Returns a pointer to the item element, which represents a referenced image (SOP Instance) under the "Referenced Image Sequence" in the "Presentation State Module".

Parameter

Description

hDS

A DICOM handle.

pszSOPInstanceUID

SOP Instance UID of the image whose item element will be retrieved.

Returns

!NULL

The function was successful.

NULL

An error occurred. Refer to the Return Code.

Comments

This function will return a pointer to the item element, which represents a referenced image (SOP Instance) under the "Referenced Image Sequence" in the "Presentation State Module". A NULL pointer will be returned if the item could not be found.

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_DicomSetPresStateInfo, L_DicomGetPresStateInfo, L_DicomAddPresStateImageRefByFileName, L_DicomAddPresStateImageRefByDS, L_DicomRemovePresStateImageRefBySOPInstance, L_DicomRemoveAllPresStateImageRefs, L_DicomGetPresStateImageRefSOPInstance, L_DicomGetPresStateImageRefCount, L_DicomFindFirstPresStateRefSeriesItem, L_DicomFindNextPresStateRefSeriesItem

Topics:

Working with DICOM Annotations

 

Dicom Annotations: Presentation State Module

Example

L_INT DicomGetPresStateImageRefBySOPInstanceExample(
   HDICOMDS hPresStateDS,
   L_TCHAR*  pszSOPInstanceUID)
{
   L_TCHAR*  pszClassUID = NULL;
   L_TCHAR   szText[256] = TEXT("\0");
   pDICOMELEMENT pElement = L_DicomGetPresStateImageRefBySOPInstance (hPresStateDS,
                                                                     pszSOPInstanceUID);
   if (pElement)
   {
      pElement = L_DicomGetChildElement(hPresStateDS,pElement, TRUE);
      if (pElement)
      {
         pElement    = L_DicomFindFirstElement( hPresStateDS,pElement, 
                                                TAG_REFERENCED_SOP_CLASS_UID, 
                                                TRUE);
         pszClassUID = L_DicomGetStringValue(hPresStateDS,pElement, 0, 1);
         if (pszClassUID)
         {
            wsprintf(szText, TEXT("Image Referenced SOP class UID is: %s "), pszClassUID);
            MessageBox( NULL, 
                        szText, 
                        TEXT("Note"), 
                        MB_OK);      
         }
      }
      return DICOM_SUCCESS;
   }
   return DICOM_ERROR_NULL_PTR;
}
Products | Support | Contact Us | Copyright Notices
© 2006-2014 All Rights Reserved. LEAD Technologies, Inc.