WM_DisconnectChildren

C Specification

#include <nitro/wm.h>

WMErrCode WM_DisconnectChildren( WMCallbackFunc callback , u16 aidBitmap );

Arguments

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.

Return Values

Returns the results of the WMErrCode enumerated type process.

Description

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.

See Also

WM_StartParent, WM_Disconnect

Revision History

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