DiMgslEnableTransmitter


Prototype  
NTSTATUS DiMgslEnableTransmitter( void *Handle,
                                  BOOL EnableFlag );
Parameters  
Handle
handle to open port
EnableFlag
Zero disables transmitter, non-zero enables transmitter
Return Value  
STATUS_SUCCESS
Success
STATUS_INVALID_HANDLE
Handle is invalid

Enable or disable the transmitter. Calling DiMgslTransmit automatically enables the transmitter. When not sending data, the transmitter sends idle characters until explicitly disabled with EnableFlag set to zero. Disabling the transmitter immediately discard current and buffered transmits, without sending HDLC abort.

Enabling an active transmitter or disabling an inactive transmitter has no effect and ERROR_SUCCESS is returned.

In HDLC/SDLC Loop Mode, enabling the transmitter inserts the port into the loop and disabling the transmitter removes the port from the loop. When removed from the loop, the port stops echoing the receive input to the transmit output.


Previous Contents Next