L_DicomGetLayerImageRefSOPInstance

#include "l_bitmap.h"

L_LTDIC_API L_TCHAR* L_DicomGetLayerImageRefSOPInstance(hDS, pGraphicAnnSQItem, uImageIndex)

Returns the SOP Instance UID for a referenced image (SOP Instance) under the "Referenced Image Sequence" in a certain graphic annotation item inside the "Graphic Annotation Module".

Parameters

HDICOMDS hDS

A DICOM handle.

pDICOMELEMENT pGraphicAnnSQItem

Pointer to an item element under the "Graphic Annotation Sequence" (0070,0001) in the "Graphic Annotation Module".

L_UINT uImageIndex

Index of the image(SOP Instance).

Returns

Value Meaning
!NULL The function was successful.
NULL An error occurred. Refer to Return Codes.

Comments

This function will return the "SOP Instance UID" for a referenced image (SOP Instance) under the "Referenced Image Sequence" (0008,1140) in one of the items under the "Graphic Annotation Sequence" (0070,0001) in the "Graphic Annotation Module". Use this function along with L_DicomGetLayerImageRefCount in order to enumerate all the referenced images under a certain "Graphic Annotation Sequence" item.

Required DLLs and Libraries

Platforms

Win32, x64, Linux.

See Also

Functions

Topics

Example

L_INT DicomGetLayerImageRefSOPInstanceExample(HDICOMDS hPresStateDS)  
{ 
   L_INT          nRet; 
   L_UINT         uImageCount;  
   L_TCHAR        szText[250] = TEXT(""); 
   pDICOMELEMENT  pAnnSQItem = L_DicomFindFirstGraphicAnnSQItem(hPresStateDS); 
   nRet = L_DicomGetLayerImageRefCount(hPresStateDS, pAnnSQItem, &uImageCount);  
   if (nRet == DICOM_SUCCESS) 
   { 
      L_TCHAR*  pszInstanceUID = L_DicomGetLayerImageRefSOPInstance(hPresStateDS, pAnnSQItem, uImageCount - 1);  
      if (pszInstanceUID)  
      { 
       wsprintf(szText, TEXT("Image Referenced SOP Instance UID is: %s "), pszInstanceUID);  
         MessageBox( NULL, szText, TEXT("Note"), MB_OK); 
      } 
   } 
   return nRet; 
} 
Help Version 20.0.2020.4.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help