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


  

InstallDriverFromFragment

InstallDriverFromFragment installs a driver fragment in the unit table.

OSErr InstallDriverFromFragment(
                     CFragConnectionID fragmentConnID,
                     RegEntryIDPtr device,
                     UnitNumber beginningUnit,
                     UnitNumber endingUnit,
                     refNum *refNum);
fragmentConnID
CFM connectionID.
device
Pointer to Name Registry specification.
beginningUnit
Low unit number in unit table range.
endingUnit
High unit number in unit table range.
refNum
Resulting unit table refNum value.
DESCRIPTION

InstallDriverFromFragment installs a driver that is located in a CFM code fragment anywhere within the specified unit number range of the unit table. It invokes the driver's Initialize command, passing the RegEntryIDPtr value to it. The driver's initialization code must return noErr for InstallDriverFromFragment to complete successfully. This function returns the driver's refNum value but it does not open the driver.

IMPORTANT

If the unit table is filled throughout the range from beginningUnit to the value returned by HighestUnitNumber, and the table has not already grown to its maximum size, it can expand to accept the new driver. To use this feature, set endingUnit larger than the value returned by the HighestUnitNumber function. If endingUnit is less than or equals the returned value under these conditions, unitTblFullErr will be returned and the driver will not be installed.

RESULT CODES
noErr 0 No error
badUnitErr -21 Bad unit number
unitTblFullErr -29 Unit table or requested range full
Specific returns from Initialize , Replace , Superseded
All CFM errors (see Inside Macintosh: PowerPC System Software)

© 1999 Apple Computer, Inc. – (Last Updated 26 March 99)