NPAB_Search_Adapter
Takes a bus type and a pointer to a product ID and returns
a bus tag and unique identifier indicating where the specified product
(adapter board) was found.
- Thread Context:Blocking
Syntax
LONG NPAB_Search_Adapter (
LONG npaHandle,
LONG *scanSequence,
LONG busType,
LONG productIDLength,
BYTE *productID,
LONG *busTag,
LONG *uniqueID
);
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.
- busType
- (IN) Points to the bus type on which to perform
the search:
- productIDLength
- (IN) Byte-length of the product ID string.
- productID
- (IN) Points to a bus architecture-dependent parameter
that uniquely identifies an adapter board/peripheral/system
option. For example, for an EISA bus, the EISA product ID is defined
in the EISA Specification document. See NPAOptionStruct for an illustration
of productID.
- busTag
- (OUT) Points to an architecture-dependent value
that is used by the system to identify the bus on which the adapter
was found in the current search iteration.
- uniqueID
- (OUT) Points to an architecture-dependent value
that identifies the specific device or function. Iterative calls
to this function return information for each instance of the productID and compatible
products, including multiple instances on a single board (each has
a different function number). The slot number associated with the
adapter can be obtained from uniqueID by using NPAB_Get_Instance_Number.
Return Values
The following table lists return values and descriptions.
Remarks
The HAM calls this function iteratively to find all adapter
instances with the specified product ID. The function returns the
bus tag and the system unique ID for each adapter instance.
This function can only be used if the HAM's adapter has a
unique product ID associated with it that can be read by NetWare's
bus interface (NBI). Also, the product ID must be retrievable according
to some accepted standard, such as EISA, MCA, or PCI.