# TP_WaitCalibratedResult

## Syntax

  `#include <nitro/spi.h>`

      u32 TP_WaitCalibratedResult( TPData * result );

## Arguments

result | Pointer to the variable to obtain touch-panel values.

## Return Values

0 if touch-panel value is obtained successfully.
Non-zero value if task fails due to some error.

## Description

This function checks whether the ARM7 has set the touch panel values that were requested using the `TP_RequestSamplingAsync` function. It then acquires them as calibrated screen coordinates. (X value ranges between 0 and 255; Y value ranges between 0 and 191) The value obtained here already accounts for chattering. If no response has arrived from ARM7, it will wait internally until there is a response.

## Note

If this function is called before a response is received from ARM7, it will use an interrupt to wait 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. From within touch panel callbacks, call the `TP_GetCalibratedResult` function.

## See Also

`TP_RequestSamplingAsync, TP_GetCalibratedResult, TP_WaitRawResult, TPData`

## Revision History

2004/04/16 Initial version.

CONFIDENTIAL