ALsetqueuesize man page on IRIX

Man page or keyword search:  
man Server   31559 pages
apropos Keyword Search (all sections)
Output format
IRIX logo
[printable version]



ALgetqueuesize(3dm)					   ALgetqueuesize(3dm)

NAME
     ALgetqueuesize, ALsetqueuesize - (obsolete) get/set audio port buffer
     size information in an ALconfig structure

SYNOPSIS
     #include <dmedia/audio.h>

     long ALgetqueuesize(ALconfig config)
     int ALsetqueuesize(ALconfig config, const long size)

PARAMETER
     config   expects an ALconfig structure.  This structure is the returned
	      value of an ALnewconfig(3dm) or ALgetconfig(3dm) call.

     size     expects the number of sample locations to use for the internal
	      buffer of an audio port created by a subsequent ALopenport(3dm)
	      call.

DESCRIPTION
     ALgetqueuesize and ALsetqueuesize are obsolete and provided for backward
     compatibility. The preferred functions are alGetQueueSize(3dm) and
     alSetQueueSize(3dm), both of which use units of sample frames.

     ALgetqueuesize(3dm) returns the number of sample locations that the
     ALconfig structure specifies.

     ALsetqueuesize(3dm) changes the number of sample locations that config
     specifies.	 Later, when you call ALopenport(3dm) with this config
     structure, an audio port is created with an internal buffer of size
     sample locations.

     ALgetqueuesize(3dm) can fail for the following reason:

     AL_BAD_CONFIG   config is invalid or null.

     ALsetqueuesize(3dm) can fail for the following reasons:

     AL_BAD_CONFIG   config is invalid or null.

     AL_BAD_QSIZE    size is invalid (either negative or larger than the
		     maximum allowable queue size).

NOTE
     On IRIS systems with high-quality audio (e.g. Indigo, Indigo2, and Indy),
     the maximum queue size for a stereo port is currently 131069, the minimum
     queue size for a stereo port is 510; the maximum queue size for a mono
     port is currently 262139, and the minimum queue size for a mono port is
     1019. These values are somewhat nonintuitive. In the future, there should
     be a way to obtain these values from ALgetminmax(3dm) or a similar

									Page 1

ALgetqueuesize(3dm)					   ALgetqueuesize(3dm)

     function. Note that ALsetqueuesize(3dm) can succeed if called with values
     outside this range, but ALopenport(3dm) will fail due to a bad queue
     size.

DIAGNOSTICS
     Upon successful completion, ALgetqueuesize(3dm) returns a non-negative
     number. Otherwise, -1 is returned.

     ALsetqueuesize(3dm) returns 0 when successful. Otherwise, it returns -1.

     Both functions set an error number which can be retrieved with
     oserror(3C) in the case of failure.

SEE ALSO
     ALnewconfig(3dm), ALgetconfig(3dm), ALsetconfig(3dm), ALopenport(3dm),
     oserror(3C)

									Page 2

[top]

List of man pages available for IRIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net