next up previous
Next: Channel Read Functions Up: Host (PC) RTDX API Previous: Configuration Functions

Channel Open/Close Functions



Open Channel


long Open( BSTR Channel_String, BSTR Read_Write )

The Open function associates the interface with a named data channel. Additional channels may be opened by instantiating additional RTDX interfaces. This function must be called before accessing any other function in this interface.A channel may be opened for reading or writing. Opening a channel for both reading and writing (at the same time) is undefined.
Mode is "w" or "r" for "write" or "read", respectively. Data coming from the target is "read" by the client. In addition, you can read from the "ALL" channel. When opened, the "ALL" channel can be used to read all data being sent from the target application to the RTDX Host Library. The data is read in the order in which it was given. Writing to the "ALL" channel is undefined.

Parameters:

Channel_String Identifier for a data channel.
Read_Write How to open the data channel.
  "r" - Open for read.
  "w" - Open for write.
   
Returns:

long - Success / Failure


Close Channel


long Close( )

The Close function closes the data channel. No further operations may be performed using this channel.

Returns:

long - Success / Failure



next up previous
Next: Channel Read Functions Up: Host (PC) RTDX API Previous: Configuration Functions
H. Rogalla 2005-12-07