# MIC_DoSampling

## C Specification

      #include <nitro/spi.h>

      MICResult MIC_DoSampling(
              MICSamplingType     type ,
              void*               buf );

## Description

Samples the microphone one time

This function issues a request to the ARM7 processor to execute sampling, waits for the ARM7 processor to respond, and then returns the process result. This is the synchronous version of MIC_DoSamplingAsync.

If the input volume exceeds the minimum or maximum value, the output data will be clamped. It is possible to adjust the input volume prior to sampling using the `PM_SetAmpGain` function.

## Caution

This function waits for a PXI interrupt in order to synchronize. Do not call this function if PXI interrupts have been prohibited.

## Arguments

`type` | Sampling class of the MICSamplingType enumerator type
`buf` | Pointer to the buffer where the sampling result is stored

## Return Values

Returns 0 if request succeeds.

Returns non-zero value if request fails.

## See Also

`MIC_DoSamplingAsync`, `PM_SetAmpGain`

## Revision History

08/10/2004 Added the description relating to the input volume
06/01/2004 Initial version