L_DicomGetPresStateImageRefSOPInstance

Summary

Returns the SOP Instance UID for a referenced image (SOP Instance) under the "Referenced Image Sequence" in the "Presentation State Module".

Syntax

#include "ltdic.h"

L_LTDIC_API L_TCHAR* L_DicomGetPresStateImageRefSOPInstance(hDS, pRefSeriesSQItem, uImageIndex)

Parameters

HDICOMDS hDS

A DICOM handle.

pDICOMELEMENT pRefSeriesSQItem

Pointer to an item element under the "Referenced Series Sequence" (0008,1115) in the "Presentation State Module".

L_UINT uImageIndex

Index of the image(SOP Instance).

Returns

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

Comments

This function will return the "SOP Instance UID" for a referenced image (SOP Instance) under the "Referenced Image Sequence" (0008,1115) in one of the items under "Referenced Series Sequence" (0008,1115) in the "Presentation State Module". Use this function along with L_DicomGetPresStateImageRefCount in order to enumerate all the referenced images under the specified "Referenced Image Sequence".

Required DLLs and Libraries

Platforms

Win32, x64, Linux.

See Also

Functions

Topics

Example

L_INT DicomGetPresStateImageRefSOPInstanceExample(HDICOMDS hPresStateDS) 
{ 
   L_UINT         uImageCount; 
   L_TCHAR       szText[250] = TEXT("\0"); 
 
   pDICOMELEMENT  pSeriesSQItem = L_DicomFindFirstPresStateRefSeriesItem(hPresStateDS); 
   L_UINT16 nRet = L_DicomGetPresStateImageRefCount(  hPresStateDS, 
                                                      pSeriesSQItem,  
                                                      &uImageCount);  
   if (nRet == DICOM_SUCCESS) 
   { 
      L_TCHAR*  pszInstanceUID = L_DicomGetPresStateImageRefSOPInstance( hPresStateDS, 
                                                                        pSeriesSQItem,  
                                                                        uImageCount - 1); 
      if (pszInstanceUID) 
      { 
         wsprintf(szText, TEXT("Image Referenced SOP Instance UID is: %s "), pszInstanceUID); 
         MessageBox( NULL,  
                     szText,  
                     TEXT("Note"),  
                     MB_OK); 
      } 
      else 
         return DICOM_ERROR_NULL_PTR; 
   } 
   return nRet; 
} 
Help Version 22.0.2022.12.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.