The adi_spi_ReadWrite API submits transceiver buffers that transfers blocking
SPI data via either interrupts or the DMA controller depending on the state
bDmaMode.

Parameters:

[in]	hDevice	The handle of the SPI device.
[in]	pTransceiver	The pointer to the SPI's transceiver data.

Returns:

Status

• ADI_SPI_SUCCESS The device is successfully opened for the given
  instance.
  
• ADI_SPI_FAILURE A generalised API failure.
  
• ADI_SPI_INVALID_HANDLE [D] An invalid device handle.
  
• ADI_SPI_QUEUE_FULL The submitted transceiver failed, the queue is
  full.
  
• ADI_SPI_SIZE_ERROR Buffer size is not a multiple of the transfer
  word size
  
• ADI_SPI_INVALID_POINTER Transceiver pointer error
  
• ADI_SPI_SEMAPHORE_PEND_FAILED The spi semaphore pend has failed
  

This function read/writes a transceiver under interrupt control or DMA
control depending on the configuration of bDMAMode parameter. bDMAMode is
configurable via the adi_spi_EnableDmaMode API. The transceiver transfer takes
place via a blocking mechanism. The transceiver includes a prologue buffer and
size, a transmit buffer and size and a receive buffer and size. The transmission
/ reception of each of these buffers is optional.

The prologue buffer is optional (set to NULL with a zero size if not
required) and can be used to send common SPI header or protocol fields.

The transmit buffer is optional (set to NULL with a zero size if not
required) and defines the transmit buffer and its size in bytes.

The receive buffer is optional (set to NULL with a zero size if not required)
and defines the receive buffer and its size in bytes.

See also:

adi_spi_SubmitBuffers.

adi_spi_EnableDmaMode