L_DicomGetPresStateImageRefCount

Show in webframe

#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, Linux.

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.