Specifications

PrepareTransfer
Declaration:
STATUS PrepareTransfer (MDR_TRANSFER * MdrTransfer,
MDR_TRANSFER_ID * TransferId = NULL);
Description: Prepare a transfer.
This function prepares a transfer (record or playback). The transfer is defined using the
MdrTransfer structure. This structure is composed of the following fields:
•
RecordingNo: number of the recording to be used during the transfer
• TransferType: type of transfer to carry out (MDR_TRANSFER_TYPE_RECORD for a
record operation or
MDR_TRANSFER_TYPE_PLAYBACK for a playback operation)
•
Infinite: transfer operation is infinite (MDR_TRANSFER_INFINITE_INF) or not
infinite (
MDR_TRANSFER_INFINITE_NONINF)
•
Response: MDR Client program will wait for the transfer to complete
(
MDR_TRANSFER_RESPONSE_WAIT) or will not wait for the transfer to complete
(
MDR_TRANSFER_RESPONSE_NOWAIT)
•
StartOffsetLow: low part of the 64-bit offset of the first byte to be transferred
(only valid for playback operation)
•
StartOffsetHigh: high part of the 64-bit offset of the first byte to be transferred
(only valid for playback operation)
•
EndOffsetLow: low part of the 64-bit offset of the last byte to be transferred
(only valid for playback operation)
•
EndOffsetHigh: high part of the 64-bit offset of the last byte to be transferred
(only valid for playback operation)
Refer to the header files for more information about the
MDR_TRANSFER structure.
A transfer identifier, pointed to by
TransferId, is used to identify a transfer while
starting it, stopping it, etc. This identifier is computed by the MDR API and is an output
parameter of this function.
Returned value:
OK or ERROR.
If
ERROR is returned then the errno variable will be set accordingly. See MdrDefs.h for
MDR
errno values.
ReadRecorderBlock
Declaration:
STATUS ReadRecorderBlock (UINT FirstRecorderBlockToRead,
UINT RecorderBlocksToRead,
void * DataBuffer,
UINT DataBufferSize);
Description: Read recorder block(s) from the storage device.
This function reads one or more recorder blocks from the storage device into memory. If
the recording data (located in the recorder blocks) contains tags then these tags are read
by the MDR and are therefore present in the data buffer.
The
FirstRecorderBlockToRead parameter specifies the first recorder block to be
read.
Returned value:
OK or ERROR.
If
ERROR is returned then the errno variable will be set accordingly. See MdrDefs.h for
MDR errno values.
MDR User Guide 55
Using the ReadRecorderBlock function while making a recording affects the recording
performance. The MDR Server may stop recording due to this.
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com