# TP_RequestCalibratedSampling

## C Specification

  `#include <nitro/spi.h>`

      u32 TP_RequestCalibratedSampling( TPData * result );

## Description

This synchronous function requests from ARM7 processor the one-time touch panel values at that time and waits until it acquires those values.

The values are acquired as calibrated screen coordinates (values for which chattering measures have already been taken) (Range: x 0 – 255, y 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, this function is executed the next time the microphone sampling ends. Therefore, may take longer than usual for the function to respond.

## Caution

This function uses an interrupt to wait for a completion response from the ARM7 processor. If this function is called while FIFO receives interrupts from the ARM7 processor are prohibited, it will not be possible to return from the wait state.

## Arguments

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

## Return Values

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

## See Also

`

`TP_RequestRawSampling`, `TP_RequestSamplingAsync`

`

## Revision History

04/21/2004 Initial version