In This Topic ▼

L_DicomSetBinaryStream

Summary

Sets the binary value of an element.

Syntax

#include "Ltdic.h"

L_LTDIC_API L_BOOL L_DicomSetBinaryStream(hDS, pElement, hFile, nFileOffset, nLength)

Parameters

HDICOMDS hDS

A DICOM handle.

pDICOMELEMENT pElement

Pointer to a DICOMELEMENT structure within the Data Set.

L_HFILE hFile

File handle with read mode that contains the binary data to set from.

L_OFFSET nFileOffset

Offset (from file begging) to where to read from.

L_UINT32 nLength

Length, in bytes, of the data to read from the file, typically the file size.

Returns

Value	Meaning
TRUE	The binary value of the Data Element was set successfully.
FALSE	Could not set the binary value of the Data Element.

Comments

This function overwrites the value of the Data Element. The Value Length of the Data Element is then equal to nLength.

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.

Example

This example sets the value for an element.

L_INT DicomSetBinaryStreamExample(L_HFILE hFile, L_UINT32 nLength) 
{ 
   HDICOMDS      hDS; 
   pDICOMELEMENT pElement; 
   L_UCHAR        Buffer[2]; 
   hDS = L_DicomCreateDS(NULL); 
 
   Buffer[0] = 0; 
   Buffer[1] = 1; 
   L_DicomInitDS(hDS, CLASS_XA_BIPLANE_IMAGE_STORAGE_RETIRED, 0);  
 
   pElement = L_DicomFindFirstElement(hDS, NULL, TAG_PATIENT_NAME, FALSE); 
   if (pElement != NULL) 
   { 
      L_DicomSetBinaryStream(hDS, pElement, hFile, 0, nLength); 
   } 
 
   L_DicomFreeDS(hDS); 
   return DICOM_SUCCESS; 
}