MGSL_ASSIGNED_RESOURCES Structure


typedef struct _MGSL_ASSIGNED_RESOURCES
{
   ULONG BusType;
   ULONG BusNumber;
   ULONG DeviceNumber;
   ULONG IrqLevel;
   ULONG DmaChannel;
   ULONG IoAddress1;
   ULONG IoAddress2;
   ULONG IoAddress3;
   ULONG MemAddress1;
   ULONG MemAddress2;
   ULONG MemAddress3;
   USHORT DeviceId;
   USHORT SubsystemId;
   char SerialNumber[MGSL_MAX_SERIAL_NUMBER];

} MGSL_ASSIGNED_RESOURCES,
  *PMGSL_ASSIGNED_RESOURCES;

This structure is used with the MgslGetAssignedResources API call to retrieve the assigned resources for an open port. This allows determination of assigned resources for automatically configured devices like the SyncLink PCI adapter. This call also functions for manually configured devices.

BusType The same as the BusType member of the MGSL_PORT_CONFIG structure. Identifies the type of expansion bus : ISA, EISA, PCI, or PCMCIA.
BusNumber Zero base index of expansion bus number.
DeviceNumber PCI only. Zero based device index (0-31) identifies a device on a bus.
IrqLevel Interrupt level assigned to port.
DmaChannel DMA channel assigned to port.
IoAddress1..3 I/O base address used by port.
MemAddress1..3 Memory address used by port.
DeviceId PCI only, 16-bit PCI device ID as specified by PCI Spec 2.1
Subsystem PCI only, 16-bit PCI subsystem device ID as specified by PCI Spec 2.1
SerialNumber NULL terminated ASCII string containing adapter serial number.

The structure members that are actually used depends on the adapter type as shown below. Unused structure members are undefined on return from MgslGetAssignedResources.

SyncLink WAN ISA adapter:

BusType Used, Value: MGSL_BUS_TYPE_ISA or MGSL_BUS_TYPE_EISA.
BusNumber Used, Value: 0-255
DeviceNumber Not used
IrqLevel Interrupt level assigned to port.
DmaChannel DMA channel assigned to port.
IoAddress1 I/O base address used by port.
IoAddress2..3 Not used
MemAddress1..3 Not used
DeviceId Not used
Subsystem Not used
SerialNumber Not used

SyncLink WAN PCI adapter:

BusType Used, Value: MGSL_BUS_TYPE_PCI
BusNumber Used, Value: 0-255
DeviceNumber Used, Value: 0-31
IrqLevel Interrupt level assigned to port
DmaChannel Not used
IoAddress1 1st I/O base address used by port
IoAddress2 2nd I/O base address used by port
IoAddress3 Not used
MemAddress1 1st memory address used by port
MemAddress2 2nd memory address used by port
MemAddress3 Not used
DeviceId 0x0010 = MicroGate SyncLink PCI adapter
Subsystem 0x0010 = MicroGate SyncLink PCI adapter
SerialNumber Used

SyncLink Communications Card ISA:

BusType Used, Value: MGSL_BUS_TYPE_ISA or MGSL_BUS_TYPE_EISA.
BusNumber Used, Value: 0-255
DeviceNumber Not used
IrqLevel Interrupt level assigned to port.
DmaChannel Not used
IoAddress1 I/O base address used by port.
IoAddress2..3 Not used
MemAddress1..3 Not used
DeviceId Not used
Subsystem Not used
SerialNumber Not used

SyncLink Communications Card PCI:

BusType Used, Value: MGSL_BUS_TYPE_PCI.
BusNumber Used, Value: 0-255
DeviceNumber Used, Value: 0-31
IrqLevel Interrupt level assigned to port.
DmaChannel Not used
IoAddress1 I/O base address used by port.
IoAddress2 I/O base address used by port.
IoAddress3 not used.
MemAddress1 Not used
MemAddress2 memory address used by port
MemAddress3 Not used
DeviceId 0x0020 - Microgate SyncLink Communications Card PCI Adapter
Subsystem 0x0020 - Microgate SyncLink Communications Card PCI Adapter
SerialNumber Not used

SyncLink MultiPort PCI adapter:

BusType Used, Value: MGSL_BUS_TYPE_PCI
BusNumber Used, Value: 0-255
DeviceNumber Used, Value: 0-31
IrqLevel Interrupt level assigned to port
DmaChannel Not used
IoAddress1 1st I/O base address used by port
IoAddress2 2nd I/O base address used by port
IoAddress3 Not used
MemAddress1 1st memory address used by port
MemAddress2 2nd memory address used by port
MemAddress3 3rd memory address used by port
DeviceId 0x0030 = MicroGate SyncLink MultiPort PCI adapter
Subsystem 0x0030 = MicroGate SyncLink MultiPort PCI adapter
SerialNumber Used

SyncLink PC Card adapter:

BusType Used, Value: MGSL_BUS_TYPE_PCMCIA
BusNumber Used, Value: 0-255
DeviceNumber not used
IrqLevel Interrupt level assigned to port
DmaChannel Not used
IoAddress1 I/O base address used by port
IoAddress2-3 Not used
MemAddress1-3 not used
DeviceId 0x0050 = MicroGate SyncLink PC Card adapter
Subsystem 0x0050 = MicroGate SyncLink PC Card adapter
SerialNumber Used


Previous Contents Next