WM_StartDCF

C Specification

#include <nitro/wm.h>

WMErrCode WM_StartDCF(
WMCallbackFunc  callback ,
WMDcfRecvBuf*   recvBuf ,
u16             recvBufSize
);

Arguments

callback Specifies the callback function to be called when the notification of the status for the asynchronous process is sent or when the asynchronous process completes. This callback is called from within the interrupt handler.
recvBuf Pointer to the data receive buffer. Because the ARM7 processor writes directly to the buffer, be careful of coherency with the cache.
recvBufSize Size of the data receive buffer.

Return Values

Returns the results of the WMErrCode enumerated type process.

Description

Starts infrastructure mode communications. This function is only executable when the WM is in the CHILD state. If the return value is WM_ERRCODE_OPERATING, a callback is generated after the communication mode change process is complete. The WM changes to the DCF CHILD state. A callback is also generated when the data is received in the infrastructure mode.

See Also

WM_SetDCFData, WM_EndDCF

Revision History

06/08/2005 Added statement about callbacks being called from the interrupt handler.
10/22/2004 Changed return value type.
08/02/2004 Standardized structure names.
07/29/2004 Added to Description
07/23/2004 Initial version