L_DicomCreateDS

#include "Ltdic.h"

L_LTDIC_API HDICOMDS L_DicomCreateDS(pszPath)

L_TCHAR * pszPath;

/* character string */

Allocates the memory for the data set and sets the site of the temporary files.

Parameter	Description
pszPath	Character string containing the location of the temporary files. DICOM uses temporary files during the course of creating a file. If this parameter is NULL, the DICOM temporary files are kept in the directory Windows places its own temporary files. If this parameter is not NULL, the temporary files are placed in the specified directory.

Returns

A DICOM handle.

Comments

The allocated memory is freed by calling L_DicomFreeDS.

To initialize the newly created Data Set to contain elements of a specific class, call L_DicomInitDS.

This function must be called before calling L_DicomLoadDS, L_DicomLoadDSMemory, or L_DicomInitDS.

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

See Also

Functions:	L_DicomFreeDS, L_DicomInitDS, L_DicomLoadDS, L_DicomLoadDSMemory
Topics:	Working with Data Sets
	How to Disable the Automatic Loading of the default DICOM IOD Table

Example

This example creates and frees the Data Set

L_INT DicomCreateDSExample(L_VOID)
{
   HDICOMDS hDS;
   hDS = L_DicomCreateDS(TEXT("%UserProfile%\\My Documents\\LEADTOOLS Images\\Temp"));
   L_DicomFreeDS(hDS);

   return DICOM_SUCCESS;
}