L_DicomIsVolatileElement

#include "Ltdic.h"

L_LTDIC_API L_BOOL L_DicomIsVolatileElement(hDS, pElement)

HDICOMDS hDS;	/* a DICOM handle */
pDICOMELEMENT pElement;	/* pointer to a DICOMELEMENT structure */

Determines whether the specified element is volatile.

Parameter	Description
hDS	A DICOM handle.
pElement	Pointer to a DICOMELEMENT structure that contains the item to be deleted.

Returns

TRUE	The element is volatile.
FALSE	The element is not volatile.

Comments

The following are considered volatile elements:

TAG_TRANSFER_SYNTAX_UID
TAG_ROWS
TAG_COLUMNS
TAG_BITS_STORED
TAG_BITS_ALLOCATED
TAG_HIGH_BIT
TAG_PIXEL_REPRESENTATION
TAG_SMALLEST_IMAGE_PIXEL_VALUE
TAG_LARGEST_IMAGE_PIXEL_VALUE
TAG_SAMPLES_PER_PIXEL
TAG_PLANAR_CONFIGURATION
TAG_PHOTOMETRIC_INTERPRETATION
TAG_PIXEL_ASPECT_RATIO
TAG_PIXEL_SPACING
TAG_RED_PALETTE_COLOR_LOOKUP_TABLE_DESCRIPTOR
TAG_GREEN_PALETTE_COLOR_LOOKUP_TABLE_DESCRIPTOR
TAG_BLUE_PALETTE_COLOR_LOOKUP_TABLE_DESCRIPTOR
TAG_RED_PALETTE_COLOR_LOOKUP_TABLE_DATA
TAG_GREEN_PALETTE_COLOR_LOOKUP_TABLE_DATA
TAG_BLUE_PALETTE_COLOR_LOOKUP_TABLE_DATA
TAG_PALETTE_COLOR_LOOKUP_TABLE_UID
TAG_SLICE_VECTOR
TAG_TIME_SLOT_VECTOR
TAG_NUMBER_OF_FRAMES
TAG_NUMBER_OF_SLICES
TAG_OFFSET_FIRST_ROOT_DIRECTORY
TAG_OFFSET_LAST_ROOT_DIRECTORY
TAG_OFFSET_CHILD_DIRECTORY
TAG_OFFSET_NEXT_DIRECTORY

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

Topics:

Working with Data Sets

Example

/* This example checks if an element is volatile */
L_INT DicomIsVolatileElementExample(L_VOID)
{
   HDICOMDS      hDS;
   pDICOMELEMENT pElement;

   hDS = L_DicomCreateDS(NULL);
   L_DicomInitDS(hDS, CLASS_XA_BIPLANE_IMAGE_STORAGE_RETIRED, DS_LITTLE_ENDIAN | DS_EXPLICIT_VR);

   pElement = L_DicomGetFirstElement(hDS, NULL, FALSE, TRUE);
   if (L_DicomIsVolatileElement(hDS, pElement))
      MessageBox(NULL, TEXT("Volatile"), TEXT("Notice"), MB_OK);

   L_DicomFreeDS(hDS);
   return DICOM_SUCCESS;
}