Open Sound System
The Hitchhiker's Guide to OSS 4.1 Internals

Do you have problems with sound/audio application development? Don't panic! Click here for help!

oss_audio_open_engine

Open an audio device file

Usage

int oss_audio_open_engine(

	int dev,

	int dev_class,

	struct fileinfo *file,

	int recursive,

	int open_flags,

	int *newdev

);

Description

This function is used to open an audio device file (in /dev/oss/). It is usually called directly by the OS dependent device file interface code. Certain virtual/pseudo drivers can also use this function (this possibility is not documented and reserved for use by 4Front Technologies.

Parameters

.

Parameter Description

dev Audio engine number to be opened.

dev_class OSS device class number (don't care).

file Pointer to OSS file information structure.

recursive Reserved.

open_flags See the description of the open_flags field of adev_t
newdev Minor device number of the opened audio engine will be returned in the variable pointed by this parameter.

Return value

Negative value means error. Otherwise the audio engine index of the opened device will be returned.

Referenced by

vmix_core/vmix_core.c	Set the master sampling rate of given vmix instance.
audio/oss_audio_core.c	Audio core functionality of OSS
include/audio_core.h	Internal definitions for the OS audio core
include/internal.h	Definitions for internal use by OSS
remux/oss_remux.c	Multi channel playback support for devices with multiple stereo engines.
oss_imux/oss_imux.c	Pseudo driver for sharing one input device between multiple apps.
Linux/osscore.c	Linux kernel version specific wrapper routines.

Parameter	Description
`dev`	Audio engine number to be opened.
`dev_class`	OSS device class number (don't care).
`file`	Pointer to OSS file information structure.
`recursive`	Reserved.
`open_flags`	See the description of the open_flags field of adev_t
`newdev`	Minor device number of the opened audio engine will be returned in the variable pointed by this parameter.