The C and C++ Include Header Files

/usr/include/linux/ultrasound.h


$ cat -n /usr/include/linux/ultrasound.h

     1	/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
     2	#ifndef _ULTRASOUND_H_
     3	#define _ULTRASOUND_H_
     4	/*
     5	 *	ultrasound.h - Macros for programming the Gravis Ultrasound
     6	 *			These macros are extremely device dependent
     7	 *			and not portable.
     8	 */
     9	/*
    10	 * Copyright (C) by Hannu Savolainen 1993-1997
    11	 *
    12	 * OSS/Free for Linux is distributed under the GNU GENERAL PUBLIC LICENSE (GPL)
    13	 * Version 2 (June 1991). See the "COPYING" file distributed with this software
    14	 * for more info.
    15	 */
    16	
    17	
    18	/*
    19	 *	Private events for Gravis Ultrasound (GUS)
    20	 *
    21	 *	Format:
    22	 *		byte 0 		- SEQ_PRIVATE (0xfe)
    23	 *		byte 1 		- Synthesizer device number (0-N)
    24	 *		byte 2 		- Command (see below)
    25	 *		byte 3 		- Voice number (0-31)
    26	 *		bytes 4 and 5	- parameter P1 (unsigned short)
    27	 *		bytes 6 and 7	- parameter P2 (unsigned short)
    28	 *
    29	 *	Commands:
    30	 *		Each command affects one voice defined in byte 3.
    31	 *		Unused parameters (P1 and/or P2 *MUST* be initialized to zero).
    32	 *		_GUS_NUMVOICES	- Sets max. number of concurrent voices (P1=14-31, default 16)
    33	 *		_GUS_VOICESAMPLE- ************ OBSOLETE *************
    34	 *		_GUS_VOICEON	- Starts voice (P1=voice mode)
    35	 *		_GUS_VOICEOFF	- Stops voice (no parameters)
    36	 *		_GUS_VOICEFADE	- Stops the voice smoothly.
    37	 *		_GUS_VOICEMODE	- Alters the voice mode, don't start or stop voice (P1=voice mode)
    38	 *		_GUS_VOICEBALA	- Sets voice balance (P1, 0=left, 7=middle and 15=right, default 7)
    39	 *		_GUS_VOICEFREQ	- Sets voice (sample) playback frequency (P1=Hz)
    40	 *		_GUS_VOICEVOL	- Sets voice volume (P1=volume, 0xfff=max, 0xeff=half, 0x000=off)
    41	 *		_GUS_VOICEVOL2	- Sets voice volume (P1=volume, 0xfff=max, 0xeff=half, 0x000=off)
    42	 *				  (Like GUS_VOICEVOL but doesn't change the hw
    43	 *				  volume. It just updates volume in the voice table).
    44	 *
    45	 *		_GUS_RAMPRANGE	- Sets limits for volume ramping (P1=low volume, P2=high volume)
    46	 *		_GUS_RAMPRATE	- Sets the speed for volume ramping (P1=scale, P2=rate)
    47	 *		_GUS_RAMPMODE	- Sets the volume ramping mode (P1=ramping mode)
    48	 *		_GUS_RAMPON	- Starts volume ramping (no parameters)
    49	 *		_GUS_RAMPOFF	- Stops volume ramping (no parameters)
    50	 *		_GUS_VOLUME_SCALE - Changes the volume calculation constants
    51	 *				  for all voices.
    52	 */
    53	
    54	#define _GUS_NUMVOICES		0x00
    55	#define _GUS_VOICESAMPLE	0x01	/* OBSOLETE */
    56	#define _GUS_VOICEON		0x02
    57	#define _GUS_VOICEOFF		0x03
    58	#define _GUS_VOICEMODE		0x04
    59	#define _GUS_VOICEBALA		0x05
    60	#define _GUS_VOICEFREQ		0x06
    61	#define _GUS_VOICEVOL		0x07
    62	#define _GUS_RAMPRANGE		0x08
    63	#define _GUS_RAMPRATE		0x09
    64	#define _GUS_RAMPMODE		0x0a
    65	#define _GUS_RAMPON		0x0b
    66	#define _GUS_RAMPOFF		0x0c
    67	#define _GUS_VOICEFADE		0x0d
    68	#define _GUS_VOLUME_SCALE	0x0e
    69	#define _GUS_VOICEVOL2		0x0f
    70	#define _GUS_VOICE_POS		0x10
    71	
    72	/*
    73	 *	GUS API macros
    74	 */
    75	
    76	#define _GUS_CMD(chn, voice, cmd, p1, p2) \
    77						{_SEQ_NEEDBUF(8); _seqbuf[_seqbufptr] = SEQ_PRIVATE;\
    78						_seqbuf[_seqbufptr+1] = (chn); _seqbuf[_seqbufptr+2] = cmd;\
    79						_seqbuf[_seqbufptr+3] = voice;\
    80						*(unsigned short*)&_seqbuf[_seqbufptr+4] = p1;\
    81						*(unsigned short*)&_seqbuf[_seqbufptr+6] = p2;\
    82						_SEQ_ADVBUF(8);}
    83	
    84	#define GUS_NUMVOICES(chn, p1)			_GUS_CMD(chn, 0, _GUS_NUMVOICES, (p1), 0)
    85	#define GUS_VOICESAMPLE(chn, voice, p1)		_GUS_CMD(chn, voice, _GUS_VOICESAMPLE, (p1), 0)	/* OBSOLETE */
    86	#define GUS_VOICEON(chn, voice, p1)		_GUS_CMD(chn, voice, _GUS_VOICEON, (p1), 0)
    87	#define GUS_VOICEOFF(chn, voice)		_GUS_CMD(chn, voice, _GUS_VOICEOFF, 0, 0)
    88	#define GUS_VOICEFADE(chn, voice)		_GUS_CMD(chn, voice, _GUS_VOICEFADE, 0, 0)
    89	#define GUS_VOICEMODE(chn, voice, p1)		_GUS_CMD(chn, voice, _GUS_VOICEMODE, (p1), 0)
    90	#define GUS_VOICEBALA(chn, voice, p1)		_GUS_CMD(chn, voice, _GUS_VOICEBALA, (p1), 0)
    91	#define GUS_VOICEFREQ(chn, voice, p)		_GUS_CMD(chn, voice, _GUS_VOICEFREQ, \
    92								(p) & 0xffff, ((p) >> 16) & 0xffff)
    93	#define GUS_VOICEVOL(chn, voice, p1)		_GUS_CMD(chn, voice, _GUS_VOICEVOL, (p1), 0)
    94	#define GUS_VOICEVOL2(chn, voice, p1)		_GUS_CMD(chn, voice, _GUS_VOICEVOL2, (p1), 0)
    95	#define GUS_RAMPRANGE(chn, voice, low, high)	_GUS_CMD(chn, voice, _GUS_RAMPRANGE, (low), (high))
    96	#define GUS_RAMPRATE(chn, voice, p1, p2)	_GUS_CMD(chn, voice, _GUS_RAMPRATE, (p1), (p2))
    97	#define GUS_RAMPMODE(chn, voice, p1)		_GUS_CMD(chn, voice, _GUS_RAMPMODE, (p1), 0)
    98	#define GUS_RAMPON(chn, voice, p1)		_GUS_CMD(chn, voice, _GUS_RAMPON, (p1), 0)
    99	#define GUS_RAMPOFF(chn, voice)			_GUS_CMD(chn, voice, _GUS_RAMPOFF, 0, 0)
   100	#define GUS_VOLUME_SCALE(chn, voice, p1, p2)	_GUS_CMD(chn, voice, _GUS_VOLUME_SCALE, (p1), (p2))
   101	#define GUS_VOICE_POS(chn, voice, p)		_GUS_CMD(chn, voice, _GUS_VOICE_POS, \
   102								(p) & 0xffff, ((p) >> 16) & 0xffff)
   103	
   104	#endif