DLI Implementation and Reference Guide - Datalogics

2.16 DLI Implementation and Reference Guide
dlpdfmemfiletransientprefix function. This returns a character string with
the necessary prefix, which marks the file such that it is not written to disk.
Concepts and Facilities: Guide to the DL Pager Composition System
Call dlpdfdocwritepdf when the document is complete, and obtain the
ASPathName for the string passed to dlpdfdocwritepdf. Obtain the MDFile
representing the Files In Memory entry for the document via the
dlpdfmemfileacquire (ASPathName) function. This returns the MDFile for
the document. Then, the size of the memory buffer needed to contain the file can be
obtained with the dlpdfmemfilesize(MDFile) call, and the information itself is
returned (as a const unsigned char buffer of the size returned by the call above)
by the dlpdfmemfiledata (MDFile) function.
Copy the contents of the returned pointer as soon as possible. This pointer should not
be changed or modified, and should not be freed. Call dlpdfmemfilerelease
MDFile) to release the file, its memory and other resources once this file is finished
being used. The function will return the remaining number of acquisitions for the Files
In Memory file.
The functions to support this are:
dlpdfmemfileacquire
This function acquires the file given by the pathname passed in, and returns it as an
MDFile. A memory file is eligible to be removed when no acquisitions are
outstanding upon it.
dlpdfmemfilesize
This function returns an ASSize_t value containing the smallest size of a block of
memory (in bytes) which could contain the data of the given MDFile.
dlpdfmemfiledata
This function returns a pointer to a memory representation of this file. The contents
should be copied as soon as possible, and must be neither altered nor freed.