# TP_WaitCalibratedResult

## C Specification

`#include <nitro/spi.h>`

    u32 TP_WaitCalibratedResult( TPData * result );

## Description

This function checks whether the touch panel values that were requested using `TP_RequestSamplingAsync` have been set from ARM7. It then acquires them as calibrated screen coordinates. (Range: x = 0 – 255, y = 0 – 191)
With this, you can obtain values for which chattering measures have been taken.
If no response has arrived from ARM7, it will wait internally until there is a response.

## Notes

If this function is called before a response is received from ARM7, it will wait with an interrupt for a completion response. Therefore, if it is called while FIFO receive interrupts from ARM7 are prohibited, it may not be possible to return from wait.

If you call it during a touch panel callback, use TP_GetCalibratedResult.

## Arguments

`result` | Pointer to a variable that is used to acquire touch panel values

## Return Values

Returns 0 if touch panel value acquisition succeeds.
Returns non-zero value if touch panel value acquisition fails due to an error.

## See Also

`TP_RequestSamplingAsync`, `TP_GetCalibratedResult`, `TP_WaitRawResult`, `TPData`

## Revision History

04/16/2004 Initial version