WM_ReadMPData


C Specification

#include <nitro/wm.h>

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

Description

The method that uses this API to get the receive data from the notification of WM_STATECODE_MPEND_IND is obsolete. Use this method only for debugging. 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. When the extraction fails, it returns NULL. WMStartMPCallback.recvBuf is defined as the WMMpRecvBuf* type, and it needs to be cased as the WMMpRecvHeader* type.

Arguments

header Pointer to the header structure of all received data.
aid Specifies the AID of the child whose data you want to extract.

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.

See Also

WM_StartMP, WM_EndMP, WM_SetMPData, WM_SetPortCallback

Revision History

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.