# WM_ReadMPData

## Syntax

      #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`.

When notification of `WM_STATECODE_MPEND_IND` comes to the callback for `WM_StartMP`, it 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 cast as type `WMMpRecvHeader*`.

## See Also

`WM_StartMP, WM_EndMP, WM_SetMPData, WM_SetPortCallback`

## Revision History

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

CONFIDENTIAL