NPAB_Scan_Bus_Info

Specifies the buses that are available on the system.

Thread Context:Blocking

Syntax

    LONG NPAB_Scan_Bus_Info (
       LONG   npaHandle,
       LONG  *scanSequence,
       LONG  *busTag,
       LONG  *busType,
       BYTE **busName);
    

Parameters

npaHandle
(IN) The HAM's handle for using the NPA APIs, assigned during NPA_Register_HAM_Module.
scanSequence
(IN/OUT) Upon input, contents initialized to -1 to start the first search iteration. Upon output, receives a system-generated sequence value to be passed into subsequent calls to this function.
busTag
(OUT) Receives an architecture-dependent value used by the system to identify the bus found in the current search iteration.
busType
(OUT) Receives a value indicating the bus type of the target bus found in the current search iteration:

Value

Description

0

ISA / ISA PnP bus

1

PC MCA bus

2

PC EISA bus

3

PC Card (PCMCIA) bus

4

PCI bus

8

CardBus

busName
(OUT) Receives a pointer to a static, NULL-terminated, architecture-dependent string for the target bus found in the current search iteration. This string is determined by the system platform developer. The caller should not modify this string. To reference this string, make a copy of it.

Return Values

The following table lists return values and descriptions.

0

Successful

4

One or more of the parameters was invalid.

7

There are no more buses.

Remarks

This function scans the system for available buses on a find-first-find-next basis. The function returns busTag, busType, and busName information about the target bus for each iteration.