SendEndEnabled

Specifies whether to assert END during the transfer of the last byte of the buffer.

Syntax

virtual HRESULT SendEndEnabled(bool bEnabled) abstract;

Parameters

bEnabled

[in] true enables sending END with the last byte; false disables it.

Return value

Returns S_OK if successful, otherwise a failure HRESULT.

Remarks

On serial device sessions, if bEnabled is false, write operations will transmit the exact contents of the user buffer, without appending anything to the data being written. If bEnabled is true, VISA will perform the behavior described by the VISA attribute VI_ATTR_ASRL_END_OUT.

On GPIB, VXI, GPIB-VXI, TCP/IP INSTR, and USB device sessions, enabling the END indicator instructs VISA to include the 488.2 defined “end of message” terminator with the last byte of the write operation.

Example

The following example demonstrates use of the SendEndEnabled function.

CoAcme4321.cpp

STDMETHODIMP Acme4321::IAcme4321_OnFinalInitialize()
{
  HRESULT hr = S_OK;

  hr = io.SendEndEnabled(true);

  return hr;
}