PATH ADC Home > Documentation > Hardware > Device Managers and Drivers > PCI Card Services > Designing PCI Cards and Drivers for Power Macintosh Computers

Driver Run-Time Structure

The DriverOSRuntime structure contains information that controls how the driver is used at run time.



 
struct DriverOSRuntime {

    RuntimeOptions  driverRuntime;

    Str31           driverName;

    UInt32          driverDescReserved[8];

};



typedef OptionBits RuntimeOptions;



typedef struct DriverOSRuntime DriverOSRuntime;



typedef struct DriverOSRuntime *DriverOSRuntimePtr;

    enum { /* DriverOSRuntime bit constants */ 

        kDriverIsLoadedUponDiscovery    = 1,    /* auto-load driver */

                                                /* when discovered */

        kDriverIsOpenedUponLoad         = 2,    /* auto-open driver */

                                                /* when it is loaded */

        kDriverIsUnderExpertControl     = 4,    /* I/O expert handles */

                                                /* loads and opens */

        kDriverIsConcurrent             = 8,    /* supports concurrent */

                                                /* requests */

        kDriverQueuesIOPB               = 0x10  /* Device Manager */

                                                /* shouldn't */

                                                /* queue IOPB */

};

Field descriptions

driverRuntime: Options used to determine run-time behavior of the driver. The bits in this field have these meanings:
driverName: Driver name used by Mac OS if driver type is ndrv. Mac OS copies this name to the area pointed to by the dNamePtr field of the DCE. This field is unused for other driver types.
driverDescReserved: Reserved for future use. Set to 0.

Bit	Meaning
0	System loads driver when driver is discovered.
1	System opens driver when driver is loaded.
2	Device family expert handles driver loads and opens.
3	Driver is capable of handling concurrent requests
4	The Device Manager should not queue the I/O parameter block (IOPB) in the DCE before calling the driver.