L_DicomSetPresStateInfo

#include "l_bitmap.h"

L_UINT16 EXT_FUNCTION L_DicomSetPresStateInfo(hDS, pPresState)

HDICOMDS hDS;

/* a DICOM handle */

pDICOMPRESSTATEINFO pPresState;

/* pointer to a structure */

Sets the attributes of the "Presentation State Module".

Parameter

Description

hDS

A DICOM handle.

pPresState

Pointer to a "Presentation State Module" attributes structure.

Returns

0

SUCCESS

>0

An error occurred. Refer to Return Codes.

Comments

This function will set the attributes of the "Presentation State Module". Before calling this function, initialize pPresState->uStructSize to be sizeof(DICOMPRESSTATEINFO) and initialize all the members of the structure.

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_DicomGetPresStateInfo, L_DicomAddPresStateImageRefByFileName, L_DicomAddPresStateImageRefByDS, L_DicomRemovePresStateImageRefBySOPInstance, L_DicomRemoveAllPresStateImageRefs, L_DicomGetPresStateImageRefSOPInstance, L_DicomGetPresStateImageRefCount, L_DicomFindFirstPresStateRefSeriesItem, L_DicomFindNextPresStateRefSeriesItem, L_DicomGetPresStateImageRefBySOPInstance

Topics:

Working with DICOM Annotations

 

Dicom Annotations: Presentation State Module

Example

L_VOID UpdatePresentationStateValues(HDICOMDS hPresStateDS)
{
   L_UINT16             nRet;
   VALUEDATE            Date;
   VALUETIME            Time;
   DICOMPRESSTATEINFO   PresState;
   SYSTEMTIME           SysTime;

   GetSystemTime(&SysTime);
   Date.nYear = SysTime.wYear; 
   Date.nMonth = SysTime.wMonth; 
   Date.nDay = SysTime.wDay;

   Time.nHours = SysTime.wHour;
   Time.nMinutes = SysTime.wMinute;
   Time.nSeconds = SysTime.wSecond;

   PresState.nInstanceNumber = 1;
   PresState.pszPresLabel = "Label";
   PresState.pszPresDescription = "Description";
   PresState.pszPresCreator = "Creator";
   PresState.pPresCreationDate = &Date;
   PresState.pPresCreationTime = &Time;
   PresState.uStructSize = sizeof(DICOMPRESSTATEINFO);
   nRet = L_DicomSetPresStateInfo(hPresStateDS,&PresState);
   if (nRet == DICOM_SUCCESS)
   {
      MessageBox( NULL, "Presentation state has been successfully updated", "Error", MB_OK);
   }
}