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

  

ScanDriverCandidates

OSErr ScanDriverCandidates(
                     RegEntryIDPtr deviceID,
                     FileBasedDriverRecordPtr fileBasedDrivers,
                     ItemCount nFileBasedDrivers,
                     FileBasedDriverRecordPtr matchingDrivers,
                     ItemCount *nMatchingDrivers);
deviceID
Name Registry ID of target device.
fileBasedDrivers
List of sorted file-based driver records.
nFileBasedDrivers
Count of file-based driver records.
matchingDrivers
File-based driver records (a subset of fileBasedDrivers ).
nMatchingDrivers
Count of driver records (<= nFileBasedDrivers ).
DESCRIPTION

Given the name entry ID of a device and a list of FileBasedDriverRecord elements, ScanDriverCandidates constructs a list of matching file-based drivers that match the device name or one of the device-compatible names. The list is sorted from best match to least favorable match. Input to this service is an array of FileBasedDriverRecord elements, described in FindDriverCandidates. Clients can use ScanDriverCandidates to match drivers from a static list of candidates without having to incur the overhead of disk I/O operations.

RESULT CODES
noErr 0 No error
fnfErr -43 File not found
All CFM errors (see Inside Macintosh: PowerPC System Software)
© 1999 Apple Computer, Inc. – (Last Updated 26 March 99)