In This Topic ▼

LDicomDS::IsVolatileElement

Summary

Determines whether the specified element is volatile.

Syntax

#include "Ltdic.h"

L_BOOL LDicomDS::IsVolatileElement(pElement)

Parameters

pDICOMELEMENT pElement

Pointer to a DICOMELEMENT structure.

Returns

Value	Meaning
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

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