L_DicomFindFirstPresStateRefSeriesItem

#include "l_bitmap.h"

L_LTDIC_API pDICOMELEMENT L_DicomFindFirstPresStateRefSeriesItem(hDS)

/* a DICOM handle */

Retrieves the first item under the "Referenced Series Sequence" (0008,1115) in the "Presentation State Module".

Parameter	Description
hDS	A DICOM handle.

Returns

!NULL	A pointer to a DICOMELEMENT structure that contains the first item under the "Referenced Series Sequence" (0008,1115) in the "Presentation State Module".
NULL	No items were found

Comments

This function returns the first item under the "Referenced Series Sequence" (0008,1115) in the "Presentation State Module". Use this function along with L_DicomFindNextPresStateRefSeriesItem in order to enumerate all the items under the "Referenced Series Sequence" (0008,1115) in the "Presentation State Module".

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

See Also

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

Example

L_INT DicomFindFirstPresStateRefSeriesItemExample(HDICOMDS hPresStateDS)
{
   pDICOMELEMENT pRefSeriesItem = L_DicomFindFirstPresStateRefSeriesItem (hPresStateDS);
   while (pRefSeriesItem != NULL)
   {
      // Do something !
      pRefSeriesItem = L_DicomFindNextPresStateRefSeriesItem(hPresStateDS,pRefSeriesItem);
   }

   return DICOM_SUCCESS;
}