L_DicomFindFirstPresStateRefSeriesItem

#include "l_bitmap.h"

L_LTDIC_API pDICOMELEMENT L_DicomFindFirstPresStateRefSeriesItem(hDS)

HDICOMDS 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

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;
}