Home | History | Annotate | Line # | Download | only in libossaudio
soundcard.h revision 1.31
      1 /*	$NetBSD: soundcard.h,v 1.31 2020/10/23 09:05:20 nia Exp $	*/
      2 
      3 /*-
      4  * Copyright (c) 1997, 2020 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * This code is derived from software contributed to The NetBSD Foundation
      8  * by Lennart Augustsson and Nia Alarie.
      9  *
     10  * Redistribution and use in source and binary forms, with or without
     11  * modification, are permitted provided that the following conditions
     12  * are met:
     13  * 1. Redistributions of source code must retain the above copyright
     14  *    notice, this list of conditions and the following disclaimer.
     15  * 2. Redistributions in binary form must reproduce the above copyright
     16  *    notice, this list of conditions and the following disclaimer in the
     17  *    documentation and/or other materials provided with the distribution.
     18  *
     19  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     21  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     22  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     23  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     29  * POSSIBILITY OF SUCH DAMAGE.
     30  */
     31 
     32 /*
     33  * WARNING!  WARNING!
     34  * This is an Open Sound System compatibility layer.
     35  * Use the Native NetBSD API in <sys/audioio.h> for developing new code,
     36  * and this only for compiling programs written for other operating systems.
     37  */
     38 
     39 #ifndef _SOUNDCARD_H_
     40 #define _SOUNDCARD_H_
     41 
     42 #ifndef SOUND_VERSION
     43 #define SOUND_VERSION 0x030001
     44 #endif
     45 
     46 #define	SNDCTL_DSP_RESET		_IO  ('P', 0)
     47 #define	SNDCTL_DSP_SYNC			_IO  ('P', 1)
     48 #define	SNDCTL_DSP_SPEED		_IOWR('P', 2, int)
     49 #define	SOUND_PCM_READ_RATE		_IOR ('P', 2, int)
     50 #define	SNDCTL_DSP_STEREO		_IOWR('P', 3, int)
     51 #define	SNDCTL_DSP_GETBLKSIZE		_IOWR('P', 4, int)
     52 #define	SNDCTL_DSP_SETFMT		_IOWR('P', 5, int)
     53 #define	 AFMT_QUERY			0x00000000
     54 #define	 AFMT_MU_LAW			0x00000001
     55 #define	 AFMT_A_LAW			0x00000002
     56 #define	 AFMT_IMA_ADPCM			0x00000004
     57 #define	 AFMT_U8			0x00000008
     58 #define	 AFMT_S16_LE			0x00000010
     59 #define	 AFMT_S16_BE			0x00000020
     60 #define	 AFMT_S8			0x00000040
     61 #define	 AFMT_U16_LE			0x00000080
     62 #define	 AFMT_U16_BE			0x00000100
     63 #define	 AFMT_MPEG			0x00000200
     64 #define	 AFMT_AC3			0x00000400
     65 #define	 AFMT_S24_LE			0x00000800
     66 #define	 AFMT_S24_BE			0x00001000
     67 #define	 AFMT_S32_LE			0x00002000
     68 #define	 AFMT_S32_BE			0x00004000
     69 #define SNDCTL_DSP_SAMPLESIZE		SNDCTL_DSP_SETFMT
     70 #define	SOUND_PCM_READ_BITS		_IOR ('P', 5, int)
     71 #define	SNDCTL_DSP_CHANNELS		_IOWR('P', 6, int)
     72 #define SOUND_PCM_WRITE_CHANNELS	SNDCTL_DSP_CHANNELS
     73 #define	SOUND_PCM_READ_CHANNELS		_IOR ('P', 6, int)
     74 #define SOUND_PCM_WRITE_FILTER		_IOWR('P', 7, int)
     75 #define SOUND_PCM_READ_FILTER		_IOR ('P', 7, int)
     76 #define	SNDCTL_DSP_POST			_IO  ('P', 8)
     77 #define SNDCTL_DSP_SUBDIVIDE		_IOWR('P', 9, int)
     78 #define	SNDCTL_DSP_SETFRAGMENT		_IOWR('P', 10, int)
     79 #define	SNDCTL_DSP_GETFMTS		_IOR ('P', 11, int)
     80 #define SNDCTL_DSP_GETOSPACE		_IOR ('P',12, struct audio_buf_info)
     81 #define SNDCTL_DSP_GETISPACE		_IOR ('P',13, struct audio_buf_info)
     82 #define SNDCTL_DSP_NONBLOCK		_IO  ('P',14)
     83 #define SNDCTL_DSP_GETCAPS		_IOR ('P',15, int)
     84 # define DSP_CAP_REVISION		0x000000ff
     85 # define DSP_CAP_DUPLEX			0x00000100
     86 # define DSP_CAP_REALTIME		0x00000200
     87 # define DSP_CAP_BATCH			0x00000400
     88 # define DSP_CAP_COPROC			0x00000800
     89 # define DSP_CAP_TRIGGER		0x00001000
     90 # define DSP_CAP_MMAP			0x00002000
     91 # define PCM_CAP_INPUT			0x00004000
     92 # define PCM_CAP_OUTPUT			0x00008000
     93 # define PCM_CAP_MODEM			0x00010000
     94 # define PCM_CAP_HIDDEN			0x00020000
     95 #define SNDCTL_DSP_GETTRIGGER		_IOR ('P', 16, int)
     96 #define SNDCTL_DSP_SETTRIGGER		_IOW ('P', 16, int)
     97 # define PCM_ENABLE_INPUT		0x00000001
     98 # define PCM_ENABLE_OUTPUT		0x00000002
     99 #define SNDCTL_DSP_GETIPTR		_IOR ('P', 17, struct count_info)
    100 #define SNDCTL_DSP_GETOPTR		_IOR ('P', 18, struct count_info)
    101 #define SNDCTL_DSP_MAPINBUF		_IOR ('P', 19, struct buffmem_desc)
    102 #define SNDCTL_DSP_MAPOUTBUF		_IOR ('P', 20, struct buffmem_desc)
    103 #define SNDCTL_DSP_SETSYNCRO		_IO  ('P', 21)
    104 #define SNDCTL_DSP_SETDUPLEX		_IO  ('P', 22)
    105 #define SNDCTL_DSP_PROFILE		_IOW ('P', 23, int)
    106 #define SNDCTL_DSP_GETODELAY		_IOR ('P', 23, int)
    107 #define	  APF_NORMAL			0
    108 #define	  APF_NETWORK			1
    109 #define   APF_CPUINTENS			2
    110 
    111 /* Need native 16 bit format which depends on byte order */
    112 #include <machine/endian_machdep.h>
    113 #if _BYTE_ORDER == _LITTLE_ENDIAN
    114 #define  AFMT_U16_NE AFMT_U16_LE
    115 #define  AFMT_U16_OE AFMT_U16_BE
    116 #define  AFMT_S16_NE AFMT_S16_LE
    117 #define  AFMT_S16_OE AFMT_S16_BE
    118 #define  AFMT_S24_NE AFMT_S24_LE
    119 #define  AFMT_S24_OE AFMT_S24_BE
    120 #define  AFMT_S32_NE AFMT_S32_LE
    121 #define  AFMT_S32_OE AFMT_S32_BE
    122 #else
    123 #define  AFMT_U16_NE AFMT_U16_BE
    124 #define  AFMT_U16_OE AFMT_U16_LE
    125 #define  AFMT_S16_NE AFMT_S16_BE
    126 #define  AFMT_S16_OE AFMT_S16_LE
    127 #define  AFMT_S24_NE AFMT_S24_BE
    128 #define  AFMT_S24_OE AFMT_S24_LE
    129 #define  AFMT_S32_NE AFMT_S32_BE
    130 #define  AFMT_S32_OE AFMT_S32_LE
    131 #endif
    132 
    133 /* Aliases */
    134 #define SOUND_PCM_WRITE_BITS		SNDCTL_DSP_SETFMT
    135 #define SOUND_PCM_WRITE_RATE		SNDCTL_DSP_SPEED
    136 #define SOUND_PCM_POST			SNDCTL_DSP_POST
    137 #define SOUND_PCM_RESET			SNDCTL_DSP_RESET
    138 #define SOUND_PCM_SYNC			SNDCTL_DSP_SYNC
    139 #define SOUND_PCM_SUBDIVIDE		SNDCTL_DSP_SUBDIVIDE
    140 #define SOUND_PCM_SETFRAGMENT		SNDCTL_DSP_SETFRAGMENT
    141 #define SOUND_PCM_GETFMTS		SNDCTL_DSP_GETFMTS
    142 #define SOUND_PCM_SETFMT		SNDCTL_DSP_SETFMT
    143 #define SOUND_PCM_GETOSPACE		SNDCTL_DSP_GETOSPACE
    144 #define SOUND_PCM_GETISPACE		SNDCTL_DSP_GETISPACE
    145 #define SOUND_PCM_NONBLOCK		SNDCTL_DSP_NONBLOCK
    146 #define SOUND_PCM_GETCAPS		SNDCTL_DSP_GETCAPS
    147 #define SOUND_PCM_GETTRIGGER		SNDCTL_DSP_GETTRIGGER
    148 #define SOUND_PCM_SETTRIGGER		SNDCTL_DSP_SETTRIGGER
    149 #define SOUND_PCM_SETSYNCRO		SNDCTL_DSP_SETSYNCRO
    150 #define SOUND_PCM_GETIPTR		SNDCTL_DSP_GETIPTR
    151 #define SOUND_PCM_GETOPTR		SNDCTL_DSP_GETOPTR
    152 #define SOUND_PCM_MAPINBUF		SNDCTL_DSP_MAPINBUF
    153 #define SOUND_PCM_MAPOUTBUF		SNDCTL_DSP_MAPOUTBUF
    154 
    155 /* Mixer defines */
    156 #define SOUND_MIXER_FIRST		0
    157 #define SOUND_MIXER_NRDEVICES		25
    158 
    159 #define SOUND_MIXER_VOLUME		0
    160 #define SOUND_MIXER_BASS		1
    161 #define SOUND_MIXER_TREBLE		2
    162 #define SOUND_MIXER_SYNTH		3
    163 #define SOUND_MIXER_PCM			4
    164 #define SOUND_MIXER_SPEAKER		5
    165 #define SOUND_MIXER_LINE		6
    166 #define SOUND_MIXER_MIC			7
    167 #define SOUND_MIXER_CD			8
    168 #define SOUND_MIXER_IMIX		9
    169 #define SOUND_MIXER_ALTPCM		10
    170 #define SOUND_MIXER_RECLEV		11
    171 #define SOUND_MIXER_IGAIN		12
    172 #define SOUND_MIXER_OGAIN		13
    173 #define SOUND_MIXER_LINE1		14
    174 #define SOUND_MIXER_LINE2		15
    175 #define SOUND_MIXER_LINE3		16
    176 #define SOUND_MIXER_DIGITAL1		17
    177 #define SOUND_MIXER_DIGITAL2		18
    178 #define SOUND_MIXER_DIGITAL3		19
    179 #define SOUND_MIXER_PHONEIN		20
    180 #define SOUND_MIXER_PHONEOUT		21
    181 #define SOUND_MIXER_VIDEO		22
    182 #define SOUND_MIXER_RADIO		23
    183 #define SOUND_MIXER_MONITOR		24
    184 
    185 #define SOUND_ONOFF_MIN			28
    186 #define SOUND_ONOFF_MAX			30
    187 
    188 #define SOUND_MIXER_NONE		31
    189 
    190 #define SOUND_DEVICE_LABELS	{"Vol  ", "Bass ", "Trebl", "Synth", "Pcm  ", "Spkr ", "Line ", \
    191 				 "Mic  ", "CD   ", "Mix  ", "Pcm2 ", "Rec  ", "IGain", "OGain", \
    192 				 "Line1", "Line2", "Line3", "Digital1", "Digital2", "Digital3", \
    193 				 "PhoneIn", "PhoneOut", "Video", "Radio", "Monitor"}
    194 
    195 #define SOUND_DEVICE_NAMES	{"vol", "bass", "treble", "synth", "pcm", "speaker", "line", \
    196 				 "mic", "cd", "mix", "pcm2", "rec", "igain", "ogain", \
    197 				 "line1", "line2", "line3", "dig1", "dig2", "dig3", \
    198 				 "phin", "phout", "video", "radio", "monitor"}
    199 
    200 #define SOUND_MIXER_RECSRC		0xff
    201 #define SOUND_MIXER_DEVMASK		0xfe
    202 #define SOUND_MIXER_RECMASK		0xfd
    203 #define SOUND_MIXER_CAPS		0xfc
    204 #define  SOUND_CAP_EXCL_INPUT		1
    205 #define SOUND_MIXER_STEREODEVS		0xfb
    206 
    207 #define MIXER_READ(dev)			_IOR('M', dev, int)
    208 
    209 #define SOUND_MIXER_READ_RECSRC		MIXER_READ(SOUND_MIXER_RECSRC)
    210 #define SOUND_MIXER_READ_DEVMASK	MIXER_READ(SOUND_MIXER_DEVMASK)
    211 #define SOUND_MIXER_READ_RECMASK	MIXER_READ(SOUND_MIXER_RECMASK)
    212 #define SOUND_MIXER_READ_STEREODEVS	MIXER_READ(SOUND_MIXER_STEREODEVS)
    213 #define SOUND_MIXER_READ_CAPS		MIXER_READ(SOUND_MIXER_CAPS)
    214 
    215 #define SOUND_MIXER_READ_VOLUME		MIXER_READ(SOUND_MIXER_VOLUME)
    216 #define SOUND_MIXER_READ_BASS		MIXER_READ(SOUND_MIXER_BASS)
    217 #define SOUND_MIXER_READ_TREBLE		MIXER_READ(SOUND_MIXER_TREBLE)
    218 #define SOUND_MIXER_READ_SYNTH		MIXER_READ(SOUND_MIXER_SYNTH)
    219 #define SOUND_MIXER_READ_PCM		MIXER_READ(SOUND_MIXER_PCM)
    220 #define SOUND_MIXER_READ_SPEAKER	MIXER_READ(SOUND_MIXER_SPEAKER)
    221 #define SOUND_MIXER_READ_LINE		MIXER_READ(SOUND_MIXER_LINE)
    222 #define SOUND_MIXER_READ_MIC		MIXER_READ(SOUND_MIXER_MIC)
    223 #define SOUND_MIXER_READ_CD		MIXER_READ(SOUND_MIXER_CD)
    224 #define SOUND_MIXER_READ_IMIX		MIXER_READ(SOUND_MIXER_IMIX)
    225 #define SOUND_MIXER_READ_ALTPCM		MIXER_READ(SOUND_MIXER_ALTPCM)
    226 #define SOUND_MIXER_READ_RECLEV		MIXER_READ(SOUND_MIXER_RECLEV)
    227 #define SOUND_MIXER_READ_IGAIN		MIXER_READ(SOUND_MIXER_IGAIN)
    228 #define SOUND_MIXER_READ_OGAIN		MIXER_READ(SOUND_MIXER_OGAIN)
    229 #define SOUND_MIXER_READ_LINE1		MIXER_READ(SOUND_MIXER_LINE1)
    230 #define SOUND_MIXER_READ_LINE2		MIXER_READ(SOUND_MIXER_LINE2)
    231 #define SOUND_MIXER_READ_LINE3		MIXER_READ(SOUND_MIXER_LINE3)
    232 
    233 #define MIXER_WRITE(dev)		_IOW ('M', dev, int)
    234 #define MIXER_WRITE_R(dev)		_IOWR('M', dev, int)
    235 
    236 #define SOUND_MIXER_WRITE_RECSRC	MIXER_WRITE(SOUND_MIXER_RECSRC)
    237 #define SOUND_MIXER_WRITE_R_RECSRC	MIXER_WRITE_R(SOUND_MIXER_RECSRC)
    238 
    239 #define SOUND_MIXER_WRITE_VOLUME	MIXER_WRITE(SOUND_MIXER_VOLUME)
    240 #define SOUND_MIXER_WRITE_BASS		MIXER_WRITE(SOUND_MIXER_BASS)
    241 #define SOUND_MIXER_WRITE_TREBLE	MIXER_WRITE(SOUND_MIXER_TREBLE)
    242 #define SOUND_MIXER_WRITE_SYNTH		MIXER_WRITE(SOUND_MIXER_SYNTH)
    243 #define SOUND_MIXER_WRITE_PCM		MIXER_WRITE(SOUND_MIXER_PCM)
    244 #define SOUND_MIXER_WRITE_SPEAKER	MIXER_WRITE(SOUND_MIXER_SPEAKER)
    245 #define SOUND_MIXER_WRITE_LINE		MIXER_WRITE(SOUND_MIXER_LINE)
    246 #define SOUND_MIXER_WRITE_MIC		MIXER_WRITE(SOUND_MIXER_MIC)
    247 #define SOUND_MIXER_WRITE_CD		MIXER_WRITE(SOUND_MIXER_CD)
    248 #define SOUND_MIXER_WRITE_IMIX		MIXER_WRITE(SOUND_MIXER_IMIX)
    249 #define SOUND_MIXER_WRITE_ALTPCM	MIXER_WRITE(SOUND_MIXER_ALTPCM)
    250 #define SOUND_MIXER_WRITE_RECLEV	MIXER_WRITE(SOUND_MIXER_RECLEV)
    251 #define SOUND_MIXER_WRITE_IGAIN		MIXER_WRITE(SOUND_MIXER_IGAIN)
    252 #define SOUND_MIXER_WRITE_OGAIN		MIXER_WRITE(SOUND_MIXER_OGAIN)
    253 #define SOUND_MIXER_WRITE_LINE1		MIXER_WRITE(SOUND_MIXER_LINE1)
    254 #define SOUND_MIXER_WRITE_LINE2		MIXER_WRITE(SOUND_MIXER_LINE2)
    255 #define SOUND_MIXER_WRITE_LINE3		MIXER_WRITE(SOUND_MIXER_LINE3)
    256 
    257 #define SOUND_MASK_VOLUME	(1 << SOUND_MIXER_VOLUME)
    258 #define SOUND_MASK_BASS		(1 << SOUND_MIXER_BASS)
    259 #define SOUND_MASK_TREBLE	(1 << SOUND_MIXER_TREBLE)
    260 #define SOUND_MASK_SYNTH	(1 << SOUND_MIXER_SYNTH)
    261 #define SOUND_MASK_PCM		(1 << SOUND_MIXER_PCM)
    262 #define SOUND_MASK_SPEAKER	(1 << SOUND_MIXER_SPEAKER)
    263 #define SOUND_MASK_LINE		(1 << SOUND_MIXER_LINE)
    264 #define SOUND_MASK_MIC		(1 << SOUND_MIXER_MIC)
    265 #define SOUND_MASK_CD		(1 << SOUND_MIXER_CD)
    266 #define SOUND_MASK_IMIX		(1 << SOUND_MIXER_IMIX)
    267 #define SOUND_MASK_ALTPCM	(1 << SOUND_MIXER_ALTPCM)
    268 #define SOUND_MASK_RECLEV	(1 << SOUND_MIXER_RECLEV)
    269 #define SOUND_MASK_IGAIN	(1 << SOUND_MIXER_IGAIN)
    270 #define SOUND_MASK_OGAIN	(1 << SOUND_MIXER_OGAIN)
    271 #define SOUND_MASK_LINE1	(1 << SOUND_MIXER_LINE1)
    272 #define SOUND_MASK_LINE2	(1 << SOUND_MIXER_LINE2)
    273 #define SOUND_MASK_LINE3	(1 << SOUND_MIXER_LINE3)
    274 #define SOUND_MASK_DIGITAL1	(1 << SOUND_MIXER_DIGITAL1)
    275 #define SOUND_MASK_DIGITAL2	(1 << SOUND_MIXER_DIGITAL2)
    276 #define SOUND_MASK_DIGITAL3	(1 << SOUND_MIXER_DIGITAL3)
    277 #define SOUND_MASK_PHONEIN	(1 << SOUND_MIXER_PHONEIN)
    278 #define SOUND_MASK_PHONEOUT	(1 << SOUND_MIXER_PHONEOUT)
    279 #define SOUND_MASK_VIDEO	(1 << SOUND_MIXER_VIDEO)
    280 #define SOUND_MASK_RADIO	(1 << SOUND_MIXER_RADIO)
    281 #define SOUND_MASK_MONITOR	(1 << SOUND_MIXER_MONITOR)
    282 
    283 typedef struct mixer_info {
    284 	char id[16];
    285 	char name[32];
    286 	int  modify_counter;
    287 	int  fillers[10];
    288 } mixer_info;
    289 
    290 typedef struct _old_mixer_info {
    291 	char id[16];
    292 	char name[32];
    293 } _old_mixer_info;
    294 
    295 #define SOUND_MIXER_INFO		_IOR('M', 101, mixer_info)
    296 #define SOUND_OLD_MIXER_INFO		_IOR('M', 101, _old_mixer_info)
    297 
    298 #define OSS_GETVERSION			_IOR ('M', 118, int)
    299 
    300 typedef struct audio_buf_info {
    301 	int fragments;
    302 	int fragstotal;
    303 	int fragsize;
    304 	int bytes;
    305 } audio_buf_info;
    306 
    307 typedef struct count_info {
    308 	int bytes;
    309 	int blocks;
    310 	int ptr;
    311 } count_info;
    312 
    313 typedef struct buffmem_desc {
    314 	unsigned int *buffer;
    315 	int size;
    316 } buffmem_desc;
    317 
    318 /* Some OSSv4 calls. */
    319 
    320 #define OSS_DEVNODE_SIZE		32
    321 #define OSS_LABEL_SIZE			16
    322 #define OSS_LONGNAME_SIZE		64
    323 #define OSS_MAX_AUDIO_DEVS		64
    324 
    325 #define SNDCTL_DSP_GETPLAYVOL		_IOR ('P',27, uint)
    326 #define SNDCTL_DSP_SETPLAYVOL		_IOW ('P',28, uint)
    327 #define SNDCTL_DSP_GETRECVOL		_IOR ('P',29, uint)
    328 #define SNDCTL_DSP_SETRECVOL		_IOW ('P',30, uint)
    329 #define SNDCTL_DSP_SKIP			_IO ('P',31)
    330 #define SNDCTL_DSP_SILENCE		_IO ('P',32)
    331 #define SNDCTL_DSP_COOKEDMODE		_IOW ('P',33, int)
    332 #define SNDCTL_DSP_GETERROR		_IOR ('P',34, struct audio_errinfo)
    333 #define SNDCTL_DSP_CURRENT_IPTR		_IOR ('P',35, oss_count_t)
    334 #define SNDCTL_DSP_CURRENT_OPTR		_IOR ('P',36, oss_count_t)
    335 
    336 typedef struct {
    337 	long long samples;
    338 	int fifo_samples;
    339 	int filler[32];			/* "Future use" */
    340 } oss_count_t;
    341 
    342 typedef struct audio_errinfo {
    343 	int play_underruns;
    344 	int rec_overruns;
    345 	unsigned int play_ptradjust;	/* Obsolete */
    346 	unsigned int rec_ptradjust;	/* Obsolete */
    347 	int play_errorcount;		/* Unused */
    348 	int rec_errorcount;		/* Unused */
    349 	int play_lasterror;		/* Unused */
    350 	int rec_lasterror;		/* Unused */
    351 	int play_errorparm;		/* Unused */
    352 	int rec_errorparm;		/* Unused */
    353 	int filler[16];			/* Unused */
    354 } audio_errinfo;
    355 
    356 typedef struct oss_sysinfo {
    357 	char product[32];
    358 	char version[32];
    359 	int versionnum;
    360 	char options[128];		/* Future use */
    361 	int numaudios;
    362 	int openedaudio[8];		/* Obsolete */
    363 	int numsynths;			/* Obsolete */
    364 	int nummidis;
    365 	int numtimers;
    366 	int nummixers;
    367 	int openedmidi[8];
    368 	int numcards;
    369 	int numaudioengines;
    370 	char license[16];
    371 	char revision_info[256];	/* Internal Use */
    372 	int filler[172];		/* For expansion */
    373 } oss_sysinfo;
    374 
    375 typedef struct oss_audioinfo {
    376 	int dev;		/* Set by caller */
    377 	char name[OSS_LONGNAME_SIZE];
    378 	int busy;
    379 	int pid;
    380 	int caps;
    381 	int iformats;
    382 	int oformats;
    383 	int magic;		/* Unused */
    384 	char cmd[OSS_LONGNAME_SIZE];
    385 	int card_number;
    386 	int port_number;
    387 	int mixer_dev;
    388 	int legacy_device;	/* Obsolete */
    389 	int enabled;
    390 	int flags;		/* Reserved */
    391 	int min_rate;
    392 	int max_rate;
    393 	int min_channels;
    394 	int max_channels;
    395 	int binding;		/* Reserved */
    396 	int rate_source;
    397 	char handle[32];
    398 #define OSS_MAX_SAMPLE_RATES	20
    399 	int nrates;
    400 	int rates[OSS_MAX_SAMPLE_RATES];
    401 	char song_name[OSS_LONGNAME_SIZE];
    402 	char label[OSS_LABEL_SIZE];
    403 	int latency;				/* In usecs -1 = unknown */
    404 	char devnode[OSS_DEVNODE_SIZE];
    405 	int next_play_engine;
    406 	int next_rec_engine;
    407 	int filler[184];			/* For expansion */
    408 } oss_audioinfo;
    409 
    410 typedef struct oss_card_info {
    411 	int card;
    412 	char shortname[16];
    413 	char longname[128];
    414 	int flags;
    415 	char hw_info[400];
    416 	int intr_count;
    417 	int ack_count;
    418 	int filler[154];
    419 } oss_card_info;
    420 
    421 #define SNDCTL_SYSINFO		_IOR ('X', 1, oss_sysinfo)
    422 #define OSS_SYSINFO		SNDCTL_SYSINFO /* Old name */
    423 #define SNDCTL_MIX_NRMIX	_IOR ('X',2, int)
    424 #define SNDCTL_MIX_NREXT	_IOWR ('X',3, int)
    425 #define SNDCTL_MIX_EXTINFO	_IOWR ('X',4, oss_mixext)
    426 #define SNDCTL_MIX_READ		_IOWR ('X',5, oss_mixer_value)
    427 #define SNDCTL_MIX_WRITE	_IOWR ('X',6, oss_mixer_value)
    428 #define SNDCTL_AUDIOINFO	_IOWR ('X',7, oss_audioinfo)
    429 #define SNDCTL_MIX_ENUMINFO	_IOWR ('X',8, oss_mixer_enuminfo)
    430 #define SNDCTL_MIXERINFO	_IOWR ('X',10, oss_mixerinfo)
    431 #define SNDCTL_CARDINFO		_IOWR ('X',11, oss_card_info)
    432 #define SNDCTL_ENGINEINFO	_IOWR ('X',12, oss_audioinfo)
    433 #define SNDCTL_AUDIOINFO_EX	_IOWR ('X',13, oss_audioinfo)
    434 #define SNDCTL_MIX_DESCRIPTION	_IOWR ('X',14, oss_mixer_enuminfo)
    435 
    436 #define MIXT_DEVROOT	 	0 /* Used for default classes */
    437 #define MIXT_GROUP	 	1 /* Used for classes */
    438 #define MIXT_ONOFF	 	2 /* Used for mute controls */
    439 #define MIXT_ENUM	 	3 /* Used for enum controls */
    440 #define MIXT_MONOSLIDER	 	4 /* Used for mono and surround controls */
    441 #define MIXT_STEREOSLIDER 	5 /* Used for stereo controls */
    442 #define MIXT_MESSAGE	 	6 /* OSS compat, unused on NetBSD */
    443 #define MIXT_MONOVU	 	7 /* OSS compat, unused on NetBSD */
    444 #define MIXT_STEREOVU	 	8 /* OSS compat, unused on NetBSD */
    445 #define MIXT_MONOPEAK	 	9 /* OSS compat, unused on NetBSD */
    446 #define MIXT_STEREOPEAK		10 /* OSS compat, unused on NetBSD */
    447 #define MIXT_RADIOGROUP		11 /* OSS compat, unused on NetBSD */
    448 #define MIXT_MARKER		12 /* OSS compat, unused on NetBSD */
    449 #define MIXT_VALUE		13 /* OSS compat, unused on NetBSD */
    450 #define MIXT_HEXVALUE		14 /* OSS compat, unused on NetBSD */
    451 #define MIXT_MONODB		15 /* OSS compat, unused on NetBSD */
    452 #define MIXT_STEREODB		16 /* OSS compat, unused on NetBSD */
    453 #define MIXT_SLIDER		17 /* OSS compat, unused on NetBSD */
    454 #define MIXT_3D			18 /* OSS compat, unused on NetBSD */
    455 #define MIXT_MONOSLIDER16	19 /* OSS compat, unused on NetBSD */
    456 #define MIXT_STEREOSLIDER16	20 /* OSS compat, unused on NetBSD */
    457 #define MIXT_MUTE		21 /* OSS compat, unused on NetBSD */
    458 /*
    459  * Should be used for Set controls.
    460  * In practice nothing uses this because it's "reserved for Sun's
    461  * implementation".
    462  */
    463 #define MIXT_ENUM_MULTI		22
    464 
    465 #define MIXF_READABLE	0x00000001 /* Value is readable: always true */
    466 #define MIXF_WRITEABLE	0x00000002 /* Value is writable: always true */
    467 #define MIXF_POLL	0x00000004 /* Can change between reads: always true */
    468 #define MIXF_HZ		0x00000008 /* OSS compat, unused on NetBSD */
    469 #define MIXF_STRING	0x00000010 /* OSS compat, unused on NetBSD */
    470 #define MIXF_DYNAMIC	0x00000010 /* OSS compat, unused on NetBSD */
    471 #define MIXF_OKFAIL	0x00000020 /* OSS compat, unused on NetBSD */
    472 #define MIXF_FLAT	0x00000040 /* OSS compat, unused on NetBSD */
    473 #define MIXF_LEGACY	0x00000080 /* OSS compat, unused on NetBSD */
    474 #define MIXF_CENTIBEL	0x00000100 /* OSS compat, unused on NetBSD */
    475 #define MIXF_DECIBEL	0x00000200 /* OSS compat, unused on NetBSD */
    476 #define MIXF_MAINVOL	0x00000400 /* OSS compat, unused on NetBSD */
    477 #define MIXF_PCMVOL	0x00000800 /* OSS compat, unused on NetBSD */
    478 #define MIXF_RECVOL	0x00001000 /* OSS compat, unused on NetBSD */
    479 #define MIXF_MONVOL	0x00002000 /* OSS compat, unused on NetBSD */
    480 #define MIXF_WIDE	0x00004000 /* OSS compat, unused on NetBSD */
    481 #define MIXF_DESCR	0x00008000 /* OSS compat, unused on NetBSD */
    482 #define MIXF_DISABLED	0x00010000 /* OSS compat, unused on NetBSD */
    483 
    484 /* None of the mixer capabilities are set on NetBSD. */
    485 #define MIXER_CAP_VIRTUAL	0x00000001	/* Virtual device */
    486 #define MIXER_CAP_LAYOUT_B	0x00000002	/* "Internal use only" */
    487 #define MIXER_CAP_NARROW	0x00000004	/* "Conserve screen space" */
    488 
    489 #define OSS_ID_SIZE		16
    490 typedef char oss_id_t[OSS_ID_SIZE];
    491 #define OSS_DEVNODE_SIZE	32
    492 typedef char oss_devnode_t[OSS_DEVNODE_SIZE];
    493 #define OSS_HANDLE_SIZE		32
    494 typedef char oss_handle_t[OSS_HANDLE_SIZE];
    495 #define	OSS_LONGNAME_SIZE	64
    496 typedef char oss_longname_t[OSS_LONGNAME_SIZE];
    497 #define	OSS_LABEL_SIZE		16
    498 typedef char oss_label_t[OSS_LABEL_SIZE];
    499 
    500 typedef struct oss_mixext_root {
    501 	oss_id_t id;
    502 	char name[48];
    503 } oss_mixext_root;
    504 
    505 typedef struct oss_mixerinfo {
    506 	int dev;
    507 	oss_id_t id;
    508 	char name[32];
    509 	int modify_counter;
    510 	int card_number;
    511 	int port_number;
    512 	oss_handle_t handle;
    513 	int magic;		/* "Reserved for internal use" */
    514 	int enabled;
    515 	int caps;
    516 	int flags;		/* "Reserved for internal use" */
    517 	int nrext;
    518 	int priority;
    519 	oss_devnode_t devnode;
    520 	int legacy_device;
    521 	int filler[245];
    522 } oss_mixerinfo;
    523 
    524 typedef struct oss_mixer_value {
    525 	int dev;	/* Set by caller */
    526 	int ctrl;	/* Set by caller */
    527 	int value;
    528 	int flags;	/* Reserved for "future use" */
    529 	int timestamp;
    530 	int filler[8];	/* Reserved for "future use" */
    531 } oss_mixer_value;
    532 
    533 #define OSS_ENUM_MAXVALUE	255
    534 #define OSS_ENUM_STRINGSIZE	3000
    535 
    536 typedef struct oss_mixer_enuminfo {
    537 	int dev;	/* Set by caller */
    538 	int ctrl;	/* Set by caller */
    539 	int nvalues;
    540 	int version;
    541 	short strindex[OSS_ENUM_MAXVALUE];
    542 	char strings[OSS_ENUM_STRINGSIZE];
    543 } oss_mixer_enuminfo;
    544 
    545 typedef struct oss_mixext {
    546 	int dev;
    547 	int ctrl;
    548 	int type;
    549 	int maxvalue;
    550 	int minvalue;
    551 	int flags;
    552 	oss_id_t id;
    553 	int parent;
    554 	int dummy;
    555 	int timestamp;
    556 	char data[64];
    557 	unsigned char enum_present[32];
    558 	int control_no;
    559 	unsigned int desc;
    560 	char extname[32];
    561 	int update_counter;
    562 	int rgbcolor;
    563 	int filler[6];
    564 } oss_mixext;
    565 
    566 
    567 /*
    568  * These are no-ops on FreeBSD, NetBSD, and Solaris,
    569  * but are defined for compatibility with OSSv4.
    570  */
    571 #define SNDCTL_SETSONG		_IOW ('Y',2, oss_longname_t)
    572 #define SNDCTL_GETSONG		_IOR ('Y',2, oss_longname_t)
    573 #define SNDCTL_SETNAME		_IOW ('Y',3, oss_longname_t)
    574 #define SNDCTL_SETLABEL		_IOW ('Y',4, oss_label_t)
    575 #define SNDCTL_GETLABEL		_IOR ('Y',4, oss_label_t)
    576 
    577 #define ioctl _oss_ioctl
    578 /*
    579  * If we already included <sys/ioctl.h>, then we define our own prototype,
    580  * else we depend on <sys/ioctl.h> to do it for us. We do it this way, so
    581  * that we don't define the prototype twice.
    582  */
    583 #ifndef _SYS_IOCTL_H_
    584 #include <sys/ioctl.h>
    585 #else
    586 __BEGIN_DECLS
    587 int _oss_ioctl(int, unsigned long, ...);
    588 __END_DECLS
    589 #endif
    590 
    591 #endif /* !_SOUNDCARD_H_ */
    592