Intel 05-1832-002 IP Phone User Manual


 
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 ai_open( ).
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 ai_open( )