IFormattedIO488::ReadIEEEBlock

Description

Reads an IEEE 488.2 Definite Binary Block from the read buffer.  If the seekToBlock argument is true, the method will look for the hash '#' character, the binary block header character, discarding data until it is found; otherwise it expects the hash to be the first character in the buffer.  If the flushToEND argument is true, the method will continue to read from the buffer after the IEEE Block, discarding the data, until an end condition is reached.  The data is interpreted and returned in the format specified by the type argument.

VB Prototype

value As Variant = ReadIEEEBlock(
  type As IEEEBinaryType,
  seekToBlock As Boolean, ' Optional Parameter
  flushToEND As Boolean ' Optional Parameter
)

C++ Prototype

HRESULT ReadIEEEBlock(
  IEEEBinaryType type,
  VARIANT_BOOL seekToBlock,
  VARIANT_BOOL flushToEND,
  VARIANT* pData
);

Parameters

type

The formatted I/O object will attempt to convert the data to this format.

seekToBlock

[Optional in Visual Basic] The method will search for the hash if it is not the first character if this parameter is true.

flushToEND

[Optional in Visual Basic] If this parameter is true, the formatted I/O object will flush the contents of the write buffer after the retrieved data. until an end condition occurs.

pData

The returned array of data.

Return Value

Refer to the table of return codes.

See Also

IO, InstrumentBigEndian, WriteString, WriteNumber, WriteList, WriteIEEEBlock, ReadString, ReadNumber, ReadList, ReadIEEEBlock, FlushWrite, FlushRead, SetBufferSize, IFormattedIO488 Overview