PM8621-BI PMC-Sierra, Inc., PM8621-BI Datasheet - Page 107

• Manufacturer Part Number: PM8621-BI
• Description: Driver, NSE/SBS Narrowband Chipset Driver
• Manufacturer: PMC-Sierra, Inc.

Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers’ Internal Use
Document ID: PMC-2021248, Issue 1
Defining a Group or Adding Devices to a Group: nbcsGroupAdd
This function handles the following: (a) define a new group and add new device(s) to it; (b)
define a new group and add existing device(s) to it; (c) add new devices to an existing group; or
(d) add existing devices to an existing group. The group handle is passed as a parameter of most
of the API functions operating in the group context. It is used by the driver to identify the group
on which the operation is to be performed.
In case (a), content of
of element
stored in the location pointed to by
also be stored in the location pointed to by
In case (b), content of
be NULL, and
elements in it.
In case (c),
pointed to an array of element
the new devices added will also be stored in the location pointed to by
In case (d),
pointed to an array of device handles with
In all cases, it is user’s responsibility to make sure that the buffer is large enough to store returned
values from the function.
Prototype
Returns
Valid States
Side Effects
numDev
pGroupHndl
pGroupHndl
pDevHandle
Success = Device Handle (to be used as an argument to most of
the Narrowband Chipset APIs)
Failure = NULL (pointer)
NBCS_MOD_READY
Changes the DEVICE state to
INT4 nbcsGroupAdd(sNBCS_HNDL* pGroupHandle,
sNBCS_DEVINFO* pDevInfo, sNBCS_USR_CTXT* pUsrCtxt,
INT4 **pperrDevice, sNBCS_HNDL *pDevHandle, UINT2
numDev)
with device information data structures. The handle of the new group will be
pGroupHndl
pGroupHndl
should be pointed to a valid group handle, and
should be pointed to a valid group handle, and
should be pointed to an array of device handles with
numDev
pGroupHndl
should be NULL,
should be NULL,
with device information data structures. The handles of all
CSDDB)
numDev
pDevHandle
NBCS_PRESENT
. The handles of all the new devices added will
elements in it.
pDevInfo
pDevInfo
.
Narrowband Chipset Device Driver Manual
Application Programming Interface
should be pointed to an array
and
pDevHandle
pperrDevice
pDevInfo
pDevHandle
numDev
.
should be
should be
should
107