LDicomDS::IsVolatileElement

#include "Ltdic.h"

L_BOOL LDicomDS::IsVolatileElement(pElement)

/* pointer to a DICOMELEMENT structure */

Determines whether the specified element is volatile.

Parameter	Description
pElement	Pointer to a DICOMELEMENT structure.

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

See Also

Topics:	Working with Data Sets
	How to Disable the Automatic Loading of the default DICOM IOD Table

Example

This example checks if an element is volatile.

L_INT LDicomDS_IsVolatileElementExample()
{
   LDicomDS *     pDS;
   pDICOMELEMENT  pElement;
   pDS = new LDicomDS(NULL);
   pDS->InitDS(CLASS_XA_BIPLANE_IMAGE_STORAGE_RETIRED, DS_LITTLE_ENDIAN | DS_EXPLICIT_VR);
   pElement = pDS->GetFirstElement(NULL, FALSE, TRUE);
   if (pDS->IsVolatileElement(pElement))
   {
      MessageBox(NULL, TEXT("Volatile"), TEXT("Notice"), MB_OK);
   }
   delete pDS;
   return DICOM_SUCCESS;
}