L_DicomGetPresStateInfo

#include "l_bitmap.h"

L_UINT16 EXT_FUNCTION L_DicomGetPresStateInfo(hDS, pPresState, uStructSize)

HDICOMDS hDS;	/* a DICOM handle */
p DICOMPRESSTATEINFO 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

0	SUCCESS
>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

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_VOID GetPresentationStateValues(HDICOMDS hPresStateDS)
{
   DICOMPRESSTATEINFO   PresState = {0};
   L_UINT16             nRet;

   nRet = L_DicomGetPresStateInfo(hPresStateDS, &PresState, sizeof(DICOMPRESSTATEINFO));
   if (nRet == DICOM_SUCCESS)
   {
    L_CHAR szText[256] = "\0";
      if(PresState.pszPresDescription)
      {
         wsprintf(szText,
                  "Presentation State description is: %s ",
                  PresState.pszPresDescription);
      }
      else
      {
         wsprintf(szText, "Presentation State description is missing");
      }
  MessageBox( NULL,
                  szText,
                  "Note",
                  MB_OK);
   }
}