ADAPTERSTRUCT

Adapter structure

Type

PSZ       AdaptDescriptName;
USHORT    AdaptFlags;
USHORT    BaseType;
USHORT    SubType;
USHORT    InterfaceType;
USHORT    HostBusType;
USHORT    HostBusWidth;
PADJUNCT  pAdjunctList;
ULONG     Reserved;

C Declaration Method

typedef struct

Remarks

The BaseType, SubType, and InterfaceType fields provide a category of the adapter being created. Refer to RMBASE.H for a complete list of adapter categories.

The HostBusType and HostBusWidth fields describe the host bus that the adapter supports. The fields also describe how the adapter is connected to the host system rather than how the adapter is connected to the devices it supports.

Fields

AdaptDescriptName

Pointer to an ASCIIZ string containing the adapter key and a brief description of the adapter. For example: "FLOPPY_# Diskette Controller"

Note: Up to the first 16 non-blank characters are used as a key to locate this adapter. The RMCreateAdapter service will substitute the "#" character with the adapter number supplied in the adjunct list.

See Device Adapter Keys for additional information concerning device adapter keys.

AdaptFlags

Adapter attribute flags. Unused flags must be set to zero by the caller.

The following is a valid flag value:

• AS_16MB_ADDRESS_LIMIT : The adapter does not support data transfers to storage above 16MB (24-bit addressing limit).

BaseType

Indicates the general functional category of the adapter:

• AS_BASE_MSD : Mass storage including disk, tape, CD-ROM, and so forth.
• AS_BASE_COMM : Communications, including serial and parallel ports.
• AS_BASE_PERIPH : System board components, including DMA controllers, interrupt controller, and so forth.

SubType

Indicates the interface supported by the adapter. For example:

• AS_BASE_MSD/AS_SUB_SCSI : SCSI Adapter
• AS_BASE_MSD/AS_SUB_IDE : IDE Adapter
• AS_BASE_COMM/AS_SUB_SERIAL : Serial Port
• AS_BASE_COMM/AS_SUB_PARALLEL : Parallel Port

InterfaceType

Provides specific interface information. For example:

• AS_BASE_COMM/AS_SUB_PARALLEL/AS_INTF_ECP : Parallel Port

HostBusType

Describes how the adapter is attached to the host system, such as ISA, EISA, Micro Channel, or PCI.

HostBusWidth

Indicates the maximum width of host bus data transfers the adapter supports. Refer to RMBASE.H for values for these fields.

pAdjunctList

Pointer to a linked list of adjunct data structures. The following adjunct structures should be included in the list:

• ADJ_ADAPTER_NUMBER: This adjunct contains the zero-based adapter number for the adapter being created.