HAI_Return_Adapter_ObjectID

Returns the Media Manager Object ID for a specific adapter.

Thread Context:Non-Blocking

Syntax

    LONG HAI_Return_Adapter_ObjectID (
       LONG   npaBusHandle,
       LONG  *objectID
       );

Parameters

npaBusHandle
(IN) NWPA-generated handle to the target bus. This parameter was output to the HAM from HAI_Activate_Bus when the bus was activated.
objectID
Points to the Media Manager Object ID for the selected adapter.

Return Values

The following table lists return values and descriptions.

zero

Successful completion.

nonzero

Failed to return the Object ID.

Remarks

HAI_Return_Adapter_ObjectID provides a means for a HAM to obtain the Media Manager Object ID associated with a selected adapter. The Media Manager creates a separate object for each instance of HAI_Activate_Bus. This implies that the single card might have multiple adapter objects if the card supports multiple channels.

For more details, refer to the NDK: Media Manager for NetWare 5.x and 6.x documentation.