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