L_DicomGetPresStateInfo

#include "l_bitmap.h"

L_LTDIC_API L_UINT16 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

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;
}