Filter
Top Products
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 dx_setuio( ) 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.