diff options
Diffstat (limited to 'misc/man9ossddk/ossddk_adev_set_magic.9ossddk')
-rw-r--r-- | misc/man9ossddk/ossddk_adev_set_magic.9ossddk | 57 |
1 files changed, 57 insertions, 0 deletions
diff --git a/misc/man9ossddk/ossddk_adev_set_magic.9ossddk b/misc/man9ossddk/ossddk_adev_set_magic.9ossddk new file mode 100644 index 0000000..cecd5c5 --- /dev/null +++ b/misc/man9ossddk/ossddk_adev_set_magic.9ossddk @@ -0,0 +1,57 @@ +'\" te +.\" Copyright (c) 2005, 4Front Technologies 2005\&. +.TH ossddk_adev_set_magic 9ossddk "12 Sep 2005" "SunOS 5.10" "OSS DDK Services" +.SH "NAME" +ossddk_adev_set_magic \- Set the device magic number +.PP +.SH "SYNOPSIS" +.nf +#include <sys/soundcard.h> +.LP +#include <sys/ossddk/ossddk.h> +.fi +.LP +\fBvoid\fR ossddk_adev_set_magic(\fBint \fIdev\fP, \fBint \fImagic\fP); +.PP +.SH "INTERFACE LEVEL" +.PP +Open Sound System specific (OSS 4.0 DDK)\&. +.PP +.SH "ARGUMENTS" +.PP +.sp +.ne 2 +.mk +\fB\fIdev\fR +.in +16n +.rt +OSS audio device number. +.in -16n +.sp +.ne 2 +.mk +\fB\fImagic\fR +.in +16n +.rt +The magic number. +.in -16n +.PP +.SH "DESCRIPTION" +.PP +Some devices may require use of dedicated configuration or setup tools. In such cases +the driver must provide some kind of magic number which the utilities can use +to find out the right device (using \fISNDCTL_AUDIOINFO(2oss)\fR). +.PP +If an magic number is needed for some device driver you must contact support@opensound.com to get a free number. Drivers developers must not use self geterated magic numbers +because they may conflict with other devices. +.PP +Using device specific utilities is not recommended but that method can be used if there +is no other choice. +.PP +.SH "SEE ALSO" +.PP +\fISNDCTL_AUDIOINFO(2oss)\fR +.LP +\fIWriting Sound Device Drivers with OSS DDK\fR +.LP +\fIOpen Sound System Programmer's Guide\fR |