在本主题▼

LDicomDS: SetEncapsulatedDocument

# include“ltdic.h”

L_UINT16LDicomDS::SetEncapsulatedDocument(pElement, bChild, pszFileDocument, pEncapsulatedDocument,pConceptNameCodeSequence)

L_UINT16LDicomDS::SetEncapsulatedDocument(pElement, bChild, pBuffer, uBufferSize, pEncapsulatedDocument,pConceptNameCodeSequence)

将封装的文档和相应的DICOM元素插入到DICOM数据集中。此特性可在版本17.5或更高版本。

参数

pDICOMELEMENTpElement

指向DICOMELEMENT结构，该结构包含数据集中的项。插入的项将作为该项的邻居或子项插入，这取决于bChild的值。

L_BOOLbChild

标志，指示插入项的位置。可能取值为:

价值	意义
真正的	新项将作为pElement的最后一个子元素插入。
假	新项将作为pElement的最后一个兄弟元素插入。

L_TCHAR* pszFileDocument

字符串，包含要封装的文件的名称。这应该是一个PDF或CDA文件。

L_UCHAR* pbuf

包含将插入DICOM数据集的源封装文档(PDF或CDA)的内存缓冲区的地址。

L_UINT32uBufferSize

内存缓冲区大小(以字节为单位)。

pDICOMENCAPSULATEDDOCUMENTpEncapsulatedDocument

指向DICOMENCAPSULATEDDOCUMENT结构，该结构由封装的文档模块属性填充。该成员不能为NULL。

pDICOMCODESEQUENCEITEMpConceptNameCodeSequence

指向DICOMCODESEQUENCEITEM结构，该结构由概念名称代码序列属性填充。该成员可以为NULL。

价值	意义
0	DICOM_SUCCESS
> 0	发生错误。指返回代码．

这个函数有两个重载，区别只在于它们如何访问封装的源文档:

第一个重载检索存储在文件中的封装文档(PDF或CDA)，并将其插入到DICOM数据集中。
第二个重载检索存储在内存缓冲区中的封装文档(PDF或CDA)，并将其插入DICOM数据集。

该协会的成员DICOMENCAPSULATEDDOCUMENT结构和DICOMCODESEQUENCEITEM结构一起表示包含在“封装文档模块属性”中的属性集。封装信息对象定义(IOD)描述了

PDF文档
CDA文档

已封装在DICOM信息对象中的信息。

有关更多信息，请参阅DICOM标准的第3部分。

DICOMENCAPSULATEDDOCUMENT结构对应于DICOM规范第3部分中描述的封装文档模块属性。为了包含概念名称代码序列元素(0040,A043)，传递一个指向pConceptNameCodeSequence项的指针。

pszFileDocument参数指向一个包含要封装的文档的文件。这应该是一个PDF或CDA文档，DICOMENCAPSULATEDDOCUMENT结构的uType成员应该相应设置。

在调用这个函数之前:

初始化pEncapsulatedDocument ->uStructSize为sizeof(DICOMENCAPSULATEDDOCUMENT)并初始化结构成员。该结构的任何指针成员都可以为NULL。NULL成员将被忽略，相应的元素将不会插入到DICOM数据集中
如果pConceptNameCodeSequence不是NULL，初始化pConceptNameCodeSequence ->uStructSize为sizeof(DICOMCODESEQUENCEITEM)并初始化所有结构成员。该结构的任何指针成员都可以为NULL。NULL成员将被忽略，相应的元素将不会插入到DICOM数据集中

必需的dll和库

LTDIC
有关所需dll和库的确切列表(基于工具包版本)，请参见应用程序中包含的文件．

平台

Win32, x64

另请参阅

功能

主题

例子

本示例将一个封装文档以及几个封装文档标记添加到现有的DICOM数据集中。

L_INT LDicomDS_SetEncapsulatedDocument(pDICOMELEMENT pElement, L_BOOL bChild, LDicomDS &ds, L_TCHAR *pszFileDocumentIn)｛DICOMENCAPSULATEDDOCUMENT封装文档= {0};EncapsulatedDocument。uStructSize =运算符(DICOMENCAPSULATEDDOCUMENT);EncapsulatedDocument。uType = encapsulation _document_pdf;EncapsulatedDocument。nInstanceNumber = 123;VALUEDATE contentDate = {2008, 12, 31};EncapsulatedDocument。pContentDate = &contentDate;VALUETIME contentTime = {12,30,00, 1};EncapsulatedDocument。pContentTime = &contentTime;VALUEDATETIME tiondatetime = {2008, 12, 31, 12, 30, 00, 01， -3};EncapsulatedDocument。pAcquisitionDateTime = & acquitiondatetime;EncapsulatedDocument。pszBurnedInAnnotation = L“是的”；EncapsulatedDocument。pszDocumentTitle = pszfiledocumententin;EncapsulatedDocument。pszVerificationFlag = L“未经证实的”；EncapsulatedDocument。pszHL7InstanceIdentifier = NULL;//调用SetEncapsulatedDocument时，'pszMIMETypeOfEncapsulatedDocument'字段被忽略//当调用SetEncapsulatedDocument时填充EncapsulatedDocument。pszMIMETypeOfEncapsulatedDocument = L"*****这是忽略时调用SetEncapsulatedDocument *****"；EncapsulatedDocument。pszListOfMIMETypes = L“图像/ jpeg \ 0应用程序/ pdf”；EncapsulatedDocument。nListOfMIMETypesCount = 2;DICOMCODESEQUENCEITEM概念名称ecodesequence = {0};ConceptNameCodeSequence。uStructSize =运算符(DICOMCODESEQUENCEITEM);ConceptNameCodeSequence。pszCodingSchemeDesignator = L“LN”；ConceptNameCodeSequence。pszCodeValue = L“12345”；ConceptNameCodeSequence。pszCodeMeaning = L“样本代码含义”；L_UINT16 uRet = ds。SetEncapsulatedDocument(pElement, bChild, pszfiledocumententin， &EncapsulatedDocument， &ConceptNameCodeSequence);返回uRet;｝

下载我们的免费评估

帮助版本21.0.2021.7.2