MGSL_PORT_CONFIG_EX Structure


This structure is used with the MgslGetPortConfigEx and MgslSetPortConfigEx API calls to retrieve and modify the hardware configuration for a port. Structure members marked as 'NT only' are used for Windows NT 3.5x-4.0. These members are not used for Windows 95-98 or for Windows 2000, which uses the plug and play facilities of the operating system to assign these values.

typedef struct _MGSL_PORT_CONFIG_EX
{
    ULONG BaseAddress;    // NT only
    ULONG IrqLevel;       // NT only
    ULONG DmaChannel;     // NT only
    ULONG BusType;        // NT only
    ULONG BusNumber;      // NT only
    ULONG DeviceID;
    ULONG MaxFrameSize;
    ULONG Flags;
} MGSL_PORT_CONFIG_EX, *PMGSL_PORT_CONFIG_EX;
BaseAddress base I/O address of adapter card
IrqLevel interrupt level used by adapter
DmaChannel DMA channel used by adapter
BusType Specifies the expansion bus type:
  MGSL_BUS_TYPE_ISA
  MGSL_BUS_TYPE_EISA
  MGSL_BUS_TYPE_PCI
  MGSL_BUS_TYPE_PCMCIA
BusNumber Zero based expansion bus number. For PCI devices the upper 16 bits is the device number and the lower 16 bits is the bus number. The BUSNUM macro extracts the PCI bus number, the DEVNUM macro extracts the PCI device number, and the BUSDEV macro creates a 32-bit value based on a 16-bit bus and device number. Set the PCI device number to 32 to indicate that the software should auto-detect the PCI device.
DeviceID Identifies the type of adapter:
SYNCLINK_DEVICE_ID SyncLink PCI or ISA adapter
SYNCLINK_GT_DEVICE_ID SyncLink single port GT PCI adapter
SYNCLINK_AC_DEVICE_ID SyncLink single port asynchronous PCI adapter
SYNCLINK_SCC_DEVICE_ID SyncLink SCC PCI or ISA adapter
SYNCLINK_SCA_DEVICE_ID SyncLink Multiport PCI adapter
SYNCLINK_PCCARD_DEVICE_ID SyncLink PC Card
MaxFrameSize Maximum frame size in bytes used by the port. This determines the number of buffers allocated when the driver loads. Send frames larger than this are rejected by the API with an error. Receive frames larger than this are discarded.
Flags

MGSL_INTERFACE_MASK defines flag bits used to select serial interface. Only the SyncLink PC Card has a software selectable serial interface. Use one of the following, mutually exclusive flags to choose the interface:
MGSL_INTERFACE_DISABLE
MGSL_INTERFACE_RS232
MGSL_INTERFACE_V35
MGSL_INTERFACE_RS422

MGSL_RTS_DRIVER_CONTROL flag enables RTS control of RS422/485 outputs. This option can be changed at run time with MgslSetOption() using the MGSL_OPT_RTS_DRIVER_CONTROL code. See the entry for MgslSetOption() for details of this option.



Previous Contents Next