L_DicomGetPresStateInfo

#include "l_bitmap.h"

L_LTDIC_API L_UINT16 L_DicomGetPresStateInfo(hDS, pPresState, uStructSize)

HDICOMDS hDS;

/* a DICOM handle */

pDICOMPRESSTATEINFO pPresState;

/* pointer to a presentation state attributes structure */

L_UINT uStructSize;

/* size of the DICOMPRESSTATEINFO structure */

Retrieves the attributes of the "Presentation State Module".

Parameter

Description

hDS

A DICOM handle.

pPresState

Pointer to a structure which will be filled with the "Presentation State Module" attributes.

uStructSize

Size of the DICOMPRESSTATEINFO structure. Pass sizeof(DICOMPRESSTATEINFO).

Returns

DICOM_SUCCESS

The function was successful.

>0

An error occurred. Refer to Return Codes.

Comments

This function will retrieve the attributes of the "Presentation State Module" and store their values in the structure pointed to by pPresState.

pPresState->uStructSize will be set to the value of the parameter uStructSize.

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_DicomSetPresStateInfo, 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_INT DicomGetPresStateInfoExample(HDICOMDS hPresStateDS)
{
   DICOMPRESSTATEINFO   PresState = {0};
   L_UINT16             nRet;
   nRet = L_DicomGetPresStateInfo(hPresStateDS, &PresState, sizeof(DICOMPRESSTATEINFO));
   if (nRet == DICOM_SUCCESS)
   {
      L_TCHAR szText[256] = TEXT("\0");
      if(PresState.pszPresDescription)
      {
         wsprintf(szText, 
                  TEXT("Presentation State description is: %s "), 
                  PresState.pszPresDescription);
      }
      else
         wsprintf(szText, TEXT("Presentation State description is missing"));
      MessageBox(NULL, szText, TEXT("Note"), MB_OK);
   }
   return nRet;
}