Filter
Top Products
50 Voice API for Windows Operating Systems Library Reference — November 2003
ai_open( ) — open an audio input device
ai_open( )
open an audio input device
!
!!
! Description
The ai_open( ) function opens an audio input device and returns a unique device handle to identify
the device. Until the device is closed, all subsequent references to the opened device must be made
using the handle.
!
!!
! Cautions
This function will fail and return -1 if:
• The device name is invalid.
• A hardware error on the board or channel is discovered.
!
!!
! 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>
Name: int ai_open(namep)
Inputs: const char *namep
• pointer to an ASCIIZ string that contains the name of a valid audio input
device
Returns: audio input device handle if successful
-1 if failure
Includes: srllib.h
dxxxlib.h
Category: Audio Input
Mode: synchronous
Platform: DM3
Parameter Description
namep points to an ASCIIZ string that contains the name of the valid audio input
device, in the form aiBn, where n is the audio input device number