L_DicomInitDS

#include "Ltdic.h"

L_VOID EXT_FUNCTION L_DicomInitDS(hDS, nClass, nFlags)

HDICOMDS hDS;	/* a DICOM handle */
L_UINT32 nClass;	/* class constant */
L_UINT16 nFlags;	/* flag */

Creates the data set, inserting the appropriate elements for the specified class.

Parameter	Description
hDS	A DICOM handle.
nClass	Value that specifies the class. For a list of default values, refer to the IOD Class Constants.
nFlags	Transfer Syntax flag that indicates the organization of the data set and the type of image compression used. Possible values and combinations are:
	Value	Meaning
	0	[0x0000] Use the default combination of: DS_LITTLE_ENDIAN \| DS_EXPLICIT_VR \| DS_COMPRESSION_NONE
	DS_LITTLE_ENDIAN	[0x0004] Byte order is Little Endian.
	DS_BIG_ENDIAN	[0x0008] Byte order is Big Endian.

	DS_IMPLICIT_VR	[0x0010] The Value Representation is implicit.
	DS_EXPLICIT_VR	[0x0020] The Value Representation is explicit.
	DS_LITTLE_ENDIAN \| DS_IMPLICIT_VR
	DS_LITTLE_ENDIAN \| DS_EXPLICIT_VR
	DS_BIG_ENDIAN \| DS_EXPLICIT_VR

Returns

None.

Comments

To create a Data Set, you must call L_DicomCreateDS, to allocate the memory required for the Data Set, before calling this function.

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

Functions:	L_DicomCreateDS, L_DicomFreeDS, L_DicomLoadDSMemory, L_DicomLoadDS
Topics:	Working with Data Sets

Example

/* This example initializes the Data Set */

L_VOID Test()
{
   HDICOMDS hDS;

   hDS = L_DicomCreateDS(NULL);

   L_DicomInitDS(hDS, CLASS_XA_BIPLANE_IMAGE_STORAGE_RETIRED, DS_METAHEADER_PRESENT |
                                              DS_LITTLE_ENDIAN |
                                              DS_EXPLICIT_VR |
                                              DS_GROUP_LENGTHS |
                                              DS_LENGTH_EXPLICIT);
   L_DicomFreeDS(hDS);
}