Intel 05-1832-002 User Manual

Page of 564
Voice API for Windows Operating Systems Library Reference — November 2003
367
set the bulk queue buffer size — dx_setchxfercnt( )
dx_setchxfercnt( )
set the bulk queue buffer size
!
!
!
Description
The dx_setchxfercnt( ) function sets the bulk queue buffer size for the channel. This function can 
change the size of the buffer used to transfer voice data between a user application and the Intel® 
telecom hardware. 
The dx_setchxfercnt( ) allows a smaller data transfer buffer size. The minimum buffer size is 1 
kbytes, and the largest is 32 kbytes. In general, this function is used in conjunction with the User 
I/O feature; for more information, see the 
 function. This function sets up the 
frequency with which the application-registered read or write functions are called by the voice 
DLL. For applications requiring more frequent access to voice data in smaller chunks, you can use 
dx_setchxfercnt( ) on a per channel basis to lower the buffer size.
Name:
int dx_setchxfercnt(chdev, bufnum, bufsize_identifier) 
Inputs:
int chdev
valid channel device handle
int bufnum
allows for smaller driver data transfer buffer size
int bufsize_identifier
equate for a buffer size
Returns:
0 to indicate successful completion
-1 if failure
Includes:
srllib.h
dxxxlib.h
Category:
Configuration
Mode:
synchronous
Platform:
DM3, Springware 
Parameter
Description
chdev 
specifies the valid device handle obtained when the device was opened 
using xx_open( ), where “xx” is the prefix identifying the device to be 
opened
bufsize_identifier
specifies the bulk queue buffer size for the channel. Use one of the 
following values: 
0 – sets the buffer size to 4 kbytes
1 – sets the buffer size to 8 kbytes 
2 – sets the buffer size to 16 kbytes 
3 – sets the buffer size to 32 kbytes (default)
4 – sets the buffer size to 2 kbytes
5 – sets the buffer size to 1 kbytes 
6 – sets the buffer size to 1.5 kbytes
Equates for these values are not available as #define in any header file.