L_DicomGetPresStateImageRefCount

#include "l_bitmap.h"

L_LTDIC_API L_UINT16 L_DicomGetPresStateImageRefCount(hDS, pRefSeriesSQItem, pCount)

HDICOMDS hDS;

/* a DICOM handle */

pDICOMELEMENT pRefSeriesSQItem;

/* pointer to a DICOMELEMENT structure */

L_UINT * pCount;

/* address of the variable to be updated */

Retrieves number of images (SOP Instances) that are referenced in an item under the "Referenced Series Sequence" (0008,1115) 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".

pCount

Pointer to a variable which will be updated with the number of referenced images.

Returns

DICOM_SUCCESS

The function was successful.

>0

An error occurred. Refer to Return Codes.

Comments

This function will return the number of images (SOP Instances) 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_DicomGetPresStateImageRefSOPInstance 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

See Also

Functions:

L_DicomSetPresStateInfo, L_DicomGetPresStateInfo, L_DicomAddPresStateImageRefByFileName, L_DicomAddPresStateImageRefByDS, L_DicomRemovePresStateImageRefBySOPInstance, L_DicomRemoveAllPresStateImageRefs, L_DicomGetPresStateImageRefSOPInstance, L_DicomFindFirstPresStateRefSeriesItem, L_DicomFindNextPresStateRefSeriesItem, L_DicomGetPresStateImageRefBySOPInstance,

Topics:

Working with DICOM Annotations

 

Dicom Annotations: Presentation State Module

Example

For an example, refer to L_DicomGetPresStateImageRefSOPInstance.