In This Topic ▼

L_DicomPrintSCUCreateFilmSession

Syntax

#include "ltdic.h"

L_LTDIC_API L_INT L_DicomPrintSCUCreateFilmSession(hPrintSCU, pParameters, bColorPrintManagement)

Parameters

HDICOMPRINTSCU hPrintSCU

A handle to Dicom Print SCU.

const pFILMSESSIONPARAMETERS pParameters

Film Session parameters.

L_BOOL bColorPrintManagement

Grayscale or Color Print Management.

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

Once a Film Session is created, the function L_DicomPrintSCUCreateFilmBox can then be used to create one or more Film Boxes in the new Film Session. Notice that only one Film Session can be handled on the Association at any time.

The function will not return until it receives the response of the Print SCP, or an error occurs. The function L_DicomPrintSCUGetLastOperationStatus can be used to obtain the status code specified in the response of the Print SCP. When the return value of the function CreateFilmSession is 0, then the Film Session was created successfully, with either a Success or Warning status code in the response of the Print SCP.

Having the Film Session created, the function L_DicomPrintSCUGetFilmSessionInstanceUID can be used to obtain its SOP Instance UID. Also, the functions L_DicomPrintSCUUpdateFilmSession, L_DicomPrintSCUPrintFilmSession, and L_DicomPrintSCUDeleteFilmSession can be used to update, print, and delete the Film Session, respectively.

The parameter pParameters points to a pFILMSESSIONPARAMETERS structure that specifies the parameters to be used when creating the Film Session. In this structure, if a string member is NULL, then the corresponding Attribute will not be included in the request to the Print SCP. Similarly, if a numeric member (that specifies an Attribute) is negative, the corresponding Attribute will not be included in the request. If pParameters is set to NULL, then the request will be sent without specifying any parameters.

All the rest of the basic Print Management functions will adopt the Meta SOP Class of the created Basic Film Session SOP Instance.