# TP_RequestCalibratedSampling

## C Specification

  `#include <nitro/spi.h>`

      u32 TP_RequestCalibratedSampling( TPData * result );

## Arguments

result | Pointer to the variable to obtain touch panel values

## Return Values

Returns 0 if the request succeeds.
Returns non-zero value if it fails.

## Description

This synchronous function requests from ARM7 processor the current touch panel values for a single event and waits until those values are acquired. The values (values for which chattering measures have already been taken) are acquired as calibrated screen coordinates. (x value takes the range of 0 – 255, and y value takes 0 – 191).
This command cannot be used during TP autosampling. Even during MIC auto sampling, this function can be used to obtain the touch panel value. (TP auto sampling is not permitted.)
However, because this function executea the next time the microphone sampling ends, more time is may be required for the results response.

## Note

This function uses an interrupt to wait for a completion response from ARM7. Notice that if it is called while FIFO receive interrupts from ARM7 are prohibited, it will not be possible to return from wait.

## See Also

TP_RequestRawSampling, TP_RequestSamplingAsync, TPData

## Revision History

04/21/2004 Initial version

CONFIDENTIAL