~ubuntu-branches/ubuntu/oneiric/oss4/oneiric-proposed

« back to all changes in this revision

Viewing changes to misc/man9ossddk/ossddk_adev_set_channels.9ossddk

  • Committer: Bazaar Package Importer
  • Author(s): Stefano Rivera
  • Date: 2011-06-16 20:37:48 UTC
  • mfrom: (5.1.3 sid)
  • Revision ID: james.westby@ubuntu.com-20110616203748-jbrxik6ql33z54co
Tags: 4.2-build2004-1ubuntu1
* Merge from Debian unstable.
  - Supports our current kernel (LP: #746048)
  Remaining changes:
  - debian/oss4-dkms.dkms.in: s/source/build/ in Kernel headers paths.
* ld-as-needed.patch: Re-order CC arguments to enable building with ld
  --as-needed (LP: #770972)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
'\" te
 
2
.\"  Copyright (c) 2005, 4Front Technologies 2005\&.
 
3
.TH ossddk_adev_set_channels 9ossddk "12 Sep 2005" "SunOS 5.10" "OSS DDK Services"
 
4
.SH "NAME"
 
5
ossddk_adev_set_channels \- Set the supported channel configuration
 
6
.PP
 
7
.SH "SYNOPSIS"
 
8
.nf
 
9
#include <sys/soundcard.h>
 
10
.LP
 
11
#include <sys/ossddk/ossddk.h>
 
12
.fi
 
13
.LP
 
14
\fBvoid\fR ossddk_adev_set_channels(\fBint \fIdev\fP, \fBint \fImin_channels\fP, \fBint \fImax_channels\fP);
 
15
.PP
 
16
.SH "INTERFACE LEVEL"
 
17
.PP
 
18
Open Sound System specific (OSS 4.0 DDK)\&.
 
19
.PP
 
20
.SH "ARGUMENTS"
 
21
.PP
 
22
.sp
 
23
.ne 2
 
24
.mk
 
25
\fB\fIdev\fR
 
26
.in +16n
 
27
.rt
 
28
OSS audio device number.
 
29
.in -16n
 
30
.sp
 
31
.ne 2
 
32
.mk
 
33
\fB\fImin_channels\fR
 
34
.in +16n
 
35
.rt
 
36
Minimum number of channels (should be at least 1).
 
37
.in -16n
 
38
.sp
 
39
.ne 2
 
40
.mk
 
41
\fB\fImax_channels\fR
 
42
.in +16n
 
43
.rt
 
44
Maximum number of channels supported.
 
45
.in -16n
 
46
.PP
 
47
.SH "DESCRIPTION"
 
48
.PP
 
49
This function sets meta information that can be read using the \fISNDCTL_AUDIOINFO(2oss)\fR ioctl call. It is recommended that the driver calls this function after installing
 
50
the audio device.
 
51
.PP
 
52
This call sets only the bounds to the number of channels supported by the device. It's
 
53
possible that the device doesn't support all possible channel configurations between
 
54
these limits. For example it may support 2 and 8 channels but not anything between
 
55
them. This is OK and the driver developer should not worry about this.
 
56
.PP
 
57
.SH "SEE ALSO"
 
58
.PP
 
59
\fISNDCTL_AUDIOINFO(2oss)\fR
 
60
.LP
 
61
\fIWriting Sound Device Drivers with OSS DDK\fR
 
62
.LP
 
63
\fIOpen Sound System Programmer's Guide\fR