IOCTL_FARC_ARC_TRANSMITTER_CTRL

Description:
Allow to enable/disable the singnal transmitter on the ARCNET controller.

Parameters:

Parameter Type Description
Input
state UCHAR enable (=0x1) or disable (=0x0) the transmitter of the ARCNET contoller.
Output
- - -

Possible errors (see also Error codes):
E_FARC_INVALID_HANDLE
E_FARC_NO_PARAMETERS

Requirements:

this function is supported only since SH ARC-USB driver v4.4.

Example:
Note, that the following example is only a fragment. It is recommended, that the driver is opened in asynchronous mode and a handle to the driver is available.

OVERLAPPED overlapped; DWORD read, err; BOOL ret; UCHAR ucTransmitterOn; overlapped.Offset = 0; overlapped.OffsetHigh = 0; overlapped.hEvent = CreateEvent(NULL,TRUE,FALSE,NULL); ... ucTransmitterOn = 0x0; // disable transmitter ret = DeviceIoControl(drvhandle, IOCTL_FARC_ARC_TRANSMITTER_CTRL, &ucTransmitterOn, sizeof(ucTransmitterOn), NULL, 0, &read, &overlapped); if (!ret) { err = GetLastError(); if (err == E_FARC_PENDING) { ret = GetOverlappedResult(drvhandle, &overlapped, &read, TRUE); if (!ret) { err = GetLastError(); // do errorhandling here } else { // transmitter was disabled } } else { // other error occured, perhaps wrong handle } } ...

See also:
DeviceIoControl()
IOCTL_FARC_INIT
ARCNET_DCB

Back to Programming Guide