MB_StartParent


C Specification

#include <nitro/mb.h>

int MB_StartParent( int channel );
    

Description

This function starts a parent operation on the specified channel. Parent processing occurs internally and ends when you call the MB_End function.

When the initialization is complete, the argument status is returned for the value passed by MB_COMM_PSTATE_INIT_COMPLETE as a callback of MB_CommSetParentStateCallback.

Internal Operation

Internally, this function calls the WM_Initialize function and automatically controls communication with any child. Therefore, the wireless library must be in a pre-intitialization state when this function is called.

Note that the corresponding MB_End function must be called to close the library.

Use the MB_StartParentFromIdle function to perform the process while the wireless library is running.

Arguments

channel The channel on which the parent communicates.

Return Values

This function returns MB_SUCCESS if the start process completes successfully.

See Also

MB_Init, MB_StartParentFromIdle, MB_End, MB_EndToIdle

Revision History

11/24/2004 Changed name from MB_StartParentEx to MB_StartParentFromIdle.
10/18/2004 Added text about the MB_StartParentEx function.
10/15/2004 Revised text about WM state when calling back.
10/05/2004 Added text about WM state when calling back.
09/10/2004 Added text about the callback.
08/09/2004 Initial version.