#include <nitro/wm.h>
WMErrCode WM_DisconnectChildren( WMCallbackFunc callback , u16 aidBitmap );
callback |
Designates the callback function to call when the asynchronous process completes. This callback is called from within the interrupt handler. |
aidBitmap | The AID bit field of the child device to be disconnected. The lowest bit is ignored, and bits 1-15 are each displayed on the AID 1-15 child devices. |
Returns the results of the WMErrCode
enumerated type process.
When a device is active as the parent device, this function disconnects all the established child devices of the designated connection. Since the bits of the child devices with no established connection are ignored, by designating 0xFFFF
inside the bit displayed in aidBitmap
, all connected child devices can be disconnected. This function can be executed only when the WM is in either the PARENT
or MP_PARENT
state. If the return value for the API is WM_ERRCODE_OPERATING
, a callback is generated after the disconnection process is complete. After the process has completed, only the connection with the designated child device is disconnected. The remaining devices will remain connected.
06/08/2005 Added statement about callbacks being called from the interrupt handler.
10/22/2004 Changed return value type.
08/20/2004 Initial version