# MIC_StartAutoSampling

## C Specification

  `#include <nitro/spi.h>`

      MICResult MIC_StartAutoSampling(
      const MICAutoParam*    param );

## Arguments

param | Specifies a pointer to the `MICAutoParam` type auto-sampling structure.

## Return Values

Returns the enumerated-type `MICResult` process result. If the asynchronous process started normally, returns `MIC_RESULT_SUCCESS`. If the process fails for some reason, returns some other value.

## Description

Starts microphone auto-sampling. This function issues a request to the ARM7 processor to start auto-sampling, waits for ARM7 to respond, and returns the process result. This is a synchronous version of `MIC_StartAutoSamplingAsync`. If the input volume exceeds the minimum or maximum value, the output data will be clamped. It is possible to set the input volume that can be sampled using the `PM_SetAmpGain` function.

## Caution

This function requires a PXI interrupt for synchronization. Do not call this function when PXI interrupts are prohibited.
It is possible to operate other ARM7 processor peripherals (SPI device) during microphone auto-sampling. However, note that if another SPI device had taken over the access for a long time, the microphone would keep returning a certain value during that time.

## See Also

`MIC_StartAutoSampling`, `MIC_StopAutoSampling`, `MIC_AdjustAutoSampling`, `PM_SetAmpGain`

## Revision History

03/08/2005 Standardized the Japanese term for "interrupt."
01/11/2005 Revised return values, revised description, added reference function.
09/17/2004 Changed the type for the argument `param`.
08/10/2001 Added the description to touch panel sampling during microphone auto sampling. Added the description regarding the input volume.
06/01/2004 Initial version.

CONFIDENTIAL