← Back to branch summary

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

« back to all changes in this revision

Viewing changes to misc/man9ossddk/ossddk_install_mixer.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
https://launchpad.net/bugs/746048
https://launchpad.net/bugs/770972
* 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:
misc/man9ossddk/ossddk_install_mixer.9ossddk
 
1
'\" te
 
2
.\"  Copyright (c) 2005, 4Front Technologies 2005\&.
 
3
.TH ossddk_install_mixer 9ossddk "12 Sep 2005" "SunOS 5.10" "OSS DDK Services"
 
4
.SH "NAME"
 
5
ossddk_install_mixer \- Creates an mixer device.
 
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
\fBint\fR ossddk_install_mixer(\fBint \fIvers\fP, \fBoss_device_t * \fIosdev\fP, \fBoss_device_t * \fImaster_osdev\fP, \fBconst char *\fIname\fP, \fBmixer_driver_t *\fIdriver\fP, \fBint \fIdriver_size\fP, \fBvoid *\fIdevc\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\fIvers\fR
 
26
.in +16n
 
27
.rt
 
28
The OSSDDK mixer interface version. Pass OSS_MIXER_DRIVER_VERSION in this parameter.
 
29
.in -16n
 
30
.sp
 
31
.ne 2
 
32
.mk
 
33
\fB\fIosdev\fR
 
34
.in +16n
 
35
.rt
 
36
OSS device handle from ossddk_register_device(9ossddk).
 
37
.in -16n
 
38
.sp
 
39
.ne 2
 
40
.mk
 
41
\fB\fImaster_osdev\fR
 
42
.in +16n
 
43
.rt
 
44
OSS device handle for the master device. Usually same as \fIosdev\fR but
 
45
virtual drivers have to give the osdev handle of the master/physical device here.
 
46
OSS uses this parameter for example to get the right iblock_cookie.
 
47
.in -16n
 
48
.sp
 
49
.ne 2
 
50
.mk
 
51
\fB\fIname\fR
 
52
.in +16n
 
53
.rt
 
54
Name of the mixer device to be shown in /dev/sndstat. Also returned by the 
 
55
SNDCTL_MIXERINFO(2oss) ioctl call.
 
56
.in -16n
 
57
.sp
 
58
.ne 2
 
59
.mk
 
60
\fB\fIdriver\fR
 
61
.in +16n
 
62
.rt
 
63
Pointer to the mixer driver callback table (mixer_driver_t).
 
64
.in -16n
 
65
.sp
 
66
.ne 2
 
67
.mk
 
68
\fB\fIdriver_size\fR
 
69
.in +16n
 
70
.rt
 
71
Set to sizeof(mixer_driver_t).
 
72
.in -16n
 
73
.sp
 
74
.ne 2
 
75
.mk
 
76
\fB\fIdevc\fR
 
77
.in +16n
 
78
.rt
 
79
Pointer to driver defined device instance data.
 
80
.in -16n
 
81
.PP
 
82
.SH "DESCRIPTION"
 
83
.PP
 
84
This call creates a mixer device file (/dev/mixer#) and returns the mixer
 
85
device number.
 
86
.PP
 
87
.SH "RETURN VALUES"
 
88
.PP
 
89
Negative value is an error code (-errno). Zero or positive is the mixer device
 
90
number created.
 
91
.PP
 
92
.SH "SEE ALSO"
 
93
.PP
 
94
\fIWriting Sound Device Drivers with OSS DDK\fR
 
95
\fIOpen Sound System Programmer's Guide\fR