LDicomDS::SetEncapsulatedDocument

#include "ltdic.h"

L_UINT16 LDicomDS::SetEncapsulatedDocument(pElement, bChild, pszFileDocument, pEncapsulatedDocument,pConceptNameCodeSequence)

L_UINT16 LDicomDS::SetEncapsulatedDocument(pElement, bChild, pBuffer, uBufferSize, pEncapsulatedDocument,pConceptNameCodeSequence)

Inserts an encapsulated document and corresponding DICOM elements into a DICOM data set.  This feature is available in version 17.5 or higher.

Returns

Comments

There are two overloads for this function, that differ only in how they access the source encapsulated document:

• The first overload retrieves an encapsulated document (PDF or CDA) stored in a file , and inserts it into a DICOM dataset.

• The second overload retrieves an encapsulated document (PDF or CDA) stored in a memory buffer, and inserts it into a DICOM dataset.

The members of the DICOMENCAPSULATEDDOCUMENT structure and the DICOMCODESEQUENCEITEM structure together represent the set of attributes contained in the "Encapsulated Document Module Attributes". The Encapsulated Information Object Definition (IOD) describes either a

• PDF document

• CDA document

that has been encapsulated within a DICOM information object.

For more information, refer to Part 3 of the DICOM standard.

The DICOMENCAPSULATEDDOCUMENT structure corresponds to the Encapsulated Document Module Attributes described in part 3 of the DICOM specification. To include the Concept Name Code Sequence element (0040,A043) pass a pointer to a pConceptNameCodeSequence item.

The pszFileDocument argument points to a file that contains the document that you want to encapsulate. This should be either a PDF or a CDA document, and the uType member of the DICOMENCAPSULATEDDOCUMENT structure should be set accordingly.

Before calling this function:

1. Initialize pEncapsulatedDocument ->uStructSize to be sizeof(DICOMENCAPSULATEDDOCUMENT) and initialize the structure members. Any of the members of the structure that are pointers can be NULL. NULL members will be ignored and the corresponding elements will not be inserted into the DICOM data set

2. If pConceptNameCodeSequence is not NULL, initialize pConceptNameCodeSequence ->uStructSize to be sizeof(DICOMCODESEQUENCEITEM) and initialize all structure members. Any of the members of the structure that are pointers can be NULL. NULL members will be ignored and the corresponding elements will not be inserted into the DICOM data set

Required DLLs and Libraries

Platforms

Win32, x64

L_INT LDicomDS_SetEncapsulatedDocument(pDICOMELEMENT pElement, L_BOOL bChild, LDicomDS &ds, L_TCHAR *pszFileDocumentIn) 
{ 
   DICOMENCAPSULATEDDOCUMENT EncapsulatedDocument = {0}; 
   EncapsulatedDocument.uStructSize = sizeof(DICOMENCAPSULATEDDOCUMENT); 
   EncapsulatedDocument.uType = ENCAPSULATED_DOCUMENT_PDF; 
   EncapsulatedDocument.nInstanceNumber = 123; 
   VALUEDATE contentDate = {2008, 12, 31}; 
   EncapsulatedDocument.pContentDate = &contentDate; 
   VALUETIME contentTime = {12, 30, 00, 1}; 
   EncapsulatedDocument.pContentTime = &contentTime; 
   VALUEDATETIME acquisitionDateTime = {2008, 12, 31, 12, 30, 00, 01, -3}; 
   EncapsulatedDocument.pAcquisitionDateTime = &acquisitionDateTime; 
   EncapsulatedDocument.pszBurnedInAnnotation               = L"YES"; 
   EncapsulatedDocument.pszDocumentTitle                    = pszFileDocumentIn; 
   EncapsulatedDocument.pszVerificationFlag                 = L"UNVERIFIED"; 
   EncapsulatedDocument.pszHL7InstanceIdentifier            = NULL; 
   // The 'pszMIMETypeOfEncapsulatedDocument' field is ignored when calling SetEncapsulatedDocument 
   // It is filled in when calling 'SetEncapsulatedDocument' 
   EncapsulatedDocument.pszMIMETypeOfEncapsulatedDocument   = L"***** This is ignored when calling SetEncapsulatedDocument *****"; 
   EncapsulatedDocument.pszListOfMIMETypes                  = L"image/jpeg\0application/pdf"; 
   EncapsulatedDocument.nListOfMIMETypesCount               = 2; 
   DICOMCODESEQUENCEITEM ConceptNameCodeSequence = {0}; 
   ConceptNameCodeSequence.uStructSize                      = sizeof(DICOMCODESEQUENCEITEM); 
   ConceptNameCodeSequence.pszCodingSchemeDesignator        = L"LN"; 
   ConceptNameCodeSequence.pszCodeValue                     = L"12345"; 
   ConceptNameCodeSequence.pszCodeMeaning                   = L"Sample Code Meaning"; 
   L_UINT16 uRet = ds.SetEncapsulatedDocument(pElement, bChild, pszFileDocumentIn, &EncapsulatedDocument, &ConceptNameCodeSequence); 
   return uRet; 
}