Intel 05-1832-002 User Manual

Page of 564
46
Voice API for Windows Operating Systems Library Reference — November 2003
ai_close( ) — close an audio input device
ai_close( )
close an audio input device 
!
!
!
Description
The ai_close( ) function closes an audio input device that was previously opened using 
This function releases the handle and breaks any link between the calling process and the device. 
!
!
!
Cautions
This function fails when an invalid channel device handle is specified.
!
!
!
Errors
If this function returns -1 to indicate failure, a system error has occurred; use dx_fileerrno( ) to 
obtain the system error value. Refer to the 
dx_fileerrno( )
 function for a list of the possible system 
error values.
!
!
!
Example
#include <windows.h>
#include <stdio.h>
#include <srllib.h>
#include <dxxxlib.h>
int main()
{
   int         aidev;         /* Audio input device handle */
   SC_TSINFO   sc_tsinfo;     /* Time slot information structure */
   long        scts;          /* TDM bus time slot */
Name:
int ai_close(devh)
Inputs:
int devh
valid audio input device handle
Returns:
0 if successful
-1 if failure
Includes:
srllib.h
dxxxlib.h
Category:
Audio Input
Mode:
synchronous 
Platform:
DM3 
Parameter
Description
devh 
specifies the valid device handle obtained when an audio input device is 
opened using