WM_ReadMPData

C Specification

#include <nitro/wm.h>

WMMpRecvData* WM_ReadMPData( const WMMpRecvHeader* header , u16 aid );

Arguments

header Pointer to the header structure of all received data.
aid Specifies the AID of the child whose data you want to extract. Use a value from 1-15.

Return Values

Returns a pointer to the data structure received from the child specified in the aid argument. Returns a value of NULL if the operation fails.

Description

The method that uses this API to get the receive data from the notification of WM_STATECODE_MPEND_IND is obsolete. For the normal process to receive data, use the callback set with WM_SetPortCallback.

Returns a pointer to the receive data structure from a child specified by the argument aid from the structure of the entire receive data assigned to WMStartMPCallback.recvBuf. Returns a value of NULL if the operation fails. WMStartMPCallback.recvBuf is defined as the WMMpRecvBuf* type, and it needs to be cased as the WMMpRecvHeader* type.

See Also

WM_StartMP, WM_EndMP, WM_SetMPData, WM_SetPortCallback

Revision History

03/02/2005 Added description of allowable range for aid argument.
11/04/2004 Revised text about obsolete method to the top.
09/25/2004 Added and revised descriptions.
07/29/2004 Added descriptions.
07/23/2004 Initial version.