TransferMode property (ILTDataTransfer)
|
long TransferMode | |
|
Overview |
Refer to Getting and Setting Capabilities. |
Remarks
Gets or sets the value indicating the transfer mode to be used by the TWAIN source. Possible values are (according to the TWAIN 1.9 specification):
|
Value |
Meaning |
|
L_TWSX_NATIVE |
Native transfer mode. |
|
L_TWSX_MEMORY |
Memory buffered transfer mode. The source will transfer strips of data to the application based on the memory buffer size. The memory buffer size can be found in the MemoryBufferSize property. |
|
L_TWSX_FILE |
File transfer mode. The TWAIN source will transfer the data to a specific file with a specific format. The name of the file is contained in the FileTransferName property and the file format is given in the ScanFileFormat property. |
This property is updated with the driver’s current setting when the GetProperties method is called.
If this property is set to L_TWSX_NATIVE, then all other ILTDataTransfer properties are considered invalid.
If the value of this property is set to L_TWSX_MEMORY and the value of the EnableDumpMemoryBuffersToFile property is set to TRUE, then the Acquire method will dump the memory buffers received from the scanner (whether compressed or not) directly to the output file specified by FileTransferName property.
If the value of this property is set to L_TWSX_MEMORY, the value of BufferMemoryCompression property is set to values other than L_TWCP_NONE, and the value of EnableDumpMemoryBuffersToFile property is set to FALSE, then the Acquire method will decompress the memory buffers received from the scanner and generate a bitmap as a result.
This generated bitmap will be returned in the pBitmap parameter of AcquirePageEvent event when it is fired by calling the Acquire method.
To update the data transfer options, set this property and the other ILTDataTransfer properties accessed by the DataTransfer property and call the SetProperties method.
See Also