L_DicomIsVolatileElement

Summary

Determines whether the specified element is volatile.

Syntax

L_LTDIC_API L_BOOL L_DicomIsVolatileElement(hDS, pElement)

Parameters

HDICOMDS hDS

A DICOM handle.

pDICOMELEMENT pElement

Pointer to a DICOMELEMENT structure that contains the item to be deleted.

Returns

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

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