Enables the MSPP channel to begin processing data.

DWORD mspEnableChannel (MSPHD chnhd)

chnhd MSPP channel handle.

• SUCCESS
• CTAERR_BAD_ARGUMENT
  The function argument had an invalid value or a required pointer argument was NULL.
• CTAERR_INVALID_CTAHD
  The CTA context handle is invalid.
• CTAERR_INVALID_HANDLE
  An invalid handle was passed as an argument to this function.
• MSPERR_INTERNAL_HANDLE
  The specified MSPP channel is not valid.
• MSPERR_INVALID_HANDLE
  The specified MSPP channel is not valid.
• MSPERR_DRIVER_COMMAND_FAILED
  An SPI command has failed.
• MSPERR_CHANNEL_NOT_CONNECTED
  The specified MSPP channel is not connected to any endpoints.

• MSPEVN_ENABLE_CHANNEL_DONE
  Generated when the data flow through an MSPP channel is enabled or resumed in response to an mspEnableChannel function call. The event.value field can contain the following:
• SUCCESS
• MSPRSN_FAILED_TO_START
  The MSPP service is unable to start the on-board
  resource.

Created MSPP channels are disabled, by default, and must be enabled before data is sent or received. When invoking mspEnableChannel, specify the channel handle (chnhd) of the connected channel. As soon as data is transferred, the connection channel processes the data and passes it on to the endpoint at the opposite end of the connection.

mspEnableChannel can also be used to re-establish data flow through a channel that had previously been disabled.

mspCreateChannel, mspDisableChannel

ret = mspEnableChannel( hChan);
if (ret != SUCCESS)
    return FAILURE;
// Wait for event
ctaWaitEvent( hCta, &Event, CTA_WAIT_FOREVER );
// Check the reason code
if ( Event.id    != MSPEVN_ENABLE_CHANNEL_DONE ||
     Event.value != CTA_REASON_FINISHED )
    return FAILURE;