Intel 05-1832-002 User Manual
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.
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
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.
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
-1 if failure
Includes:
srllib.h
dxxxlib.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
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:
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.