WM_SetDCFData

Syntax

#include <nitro/wm.h>

WMErrCode WM_SetDCFData(
        WMCallbackFunc  callback ,
        const u8*       destAdr ,
        const u16*      sendData,
        u16             sendDataSize
);

Arguments

callback Designates the callback function to call when the asynchronous process completes. This callback is called from within the interrupt handler.
destAdr Pointer to the 6-byte buffer that indicates the MAC address of the communicating partner.
sendData Pointer to the data to be send-reserved. Note that the send-reserve data is forcibly cached.
sendDataSize The size of the send-reserved data.

Return Values

Returns the results of the WMErrCode enumerated type process.

Description

Reserves data to be sent when using infrastructure mode communications. This function is executable only when the WM is in the DCF CHILD state. If the return value is WM_ERRCODE_OPERATING, a callback is generated after the data transmission process is complete.

Notes

The sendData argument is forcibly stored in the internal cache. To avoid overwriting surrounding memory regions, be sure to pass data that is 32-byte aligned.
See the Wireless Communication Library Manual (AboutWirelessManager.pdf) for additional details.

See Also

WM_StartDCF
WM_EndDCF

Revision History

2008/12/17 Added a note about how data passed in arguments is forcibly cached internally.
2005/06/08 Added the fact that the callback is called from the interrupt handler.
2004/10/22 Changed the type of return values.
2004/10/05 Changed the type of arguments.
2005/08/02 Standardized structure names.
2004/07/29 Added to Description.
2004/07/23 Initial version.


CONFIDENTIAL