Load(IntPtr,long,DicomDataSetFlags) Method

Summary

Loads a Data Set.

Syntax

C++

public void Load( 
   IntPtr buffer, 
   long bufferSize, 
   DicomDataSetFlags flags 
)

Public Overloads Sub Load( _ 
   ByVal buffer As IntPtr, _ 
   ByVal bufferSize As Long, _ 
   ByVal flags As DicomDataSetFlags _ 
)

public: 
void Load(  
   IntPtr buffer, 
   int64 bufferSize, 
   DicomDataSetFlags flags 
)

Parameters

buffer
Pointer to a buffer that contains the Data Set to be loaded.

bufferSize
Size of the buffer, in bytes.

flags
Meta-header flags and Transfer Syntax flags that indicate the Data Set characteristics to use when loading the Data Set.

Remarks

Unless you pass the DicomDataSetLoadFlags.LoadAndClose flag, This method DOES NOT make a copy of the memory pointed to by [buffer](" id="bufferparameterlink" class="popuplink.html). Therefore, DO NOT free this memory as long as you are using the Data Set referenced by this instance of the class, or until you have reset the Data Set by calling Reset. Once you have called Reset, you can repopulate the Data Set by calling Initialize, Load, or Load.

If you know certain characteristics of the Data Set in memory, you can set those in flags. Any characteristic that you do not set will be automatically determined. For example, if you know that the Meta-header is present, but you do not know the byte order, or whether the Value Representation is Implicit or Explicit, you can set only DicomDataSetFlags.MetaHeaderPresent in flags. During loading, LEADTOOLS will determine the byte order and whether the byte order is Implicit or Explicit.

If you do not know any of the characteristics of the Data Set in memory, set flags to DicomDataSetFlags.None and LEADTOOLS will automatically determine all the Data Set characteristics and load the Data Set accordingly.

Example

For an example, refer to Load.

Requirements

Target Platforms