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:
|
||||||||||||
| 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 |