L_DicomGetPresStateImageRefSOPInstance

#include "l_bitmap.h"

L_LTDIC_API L_TCHAR* L_DicomGetPresStateImageRefSOPInstance(hDS, pRefSeriesSQItem, uImageIndex)

HDICOMDS hDS;	a DICOM handle
pDICOMELEMENT pRefSeriesSQItem;	pointer to a DICOMELEMENT structure
L_UINT uImageIndex;	index of the required image

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

Parameter	Description
hDS	A DICOM handle.
pRefSeriesSQItem	Pointer to an item element under the "Referenced Series Sequence" (0008,1115) in the "Presentation State Module".
uImageIndex	Index of the image(SOP Instance).

Returns

!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

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.

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 19.0.2017.10.27

Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help

Introduction

Version History

Getting Started

Features of LEADTOOLS DICOM

Redistributables/Files To Be Included With Your Application

Functions:	L_DicomSetPresStateInfo, L_DicomGetPresStateInfo, L_DicomAddPresStateImageRefByFileName, L_DicomAddPresStateImageRefByDS, L_DicomRemovePresStateImageRefBySOPInstance, L_DicomRemoveAllPresStateImageRefs, L_DicomGetPresStateImageRefCount, L_DicomFindFirstPresStateRefSeriesItem, L_DicomFindNextPresStateRefSeriesItem, L_DicomGetPresStateImageRefBySOPInstance
Topics:	Working with DICOM Annotations
	Dicom Annotations: Presentation State Module