Module Name: src
Committed By: isaki
Date: Wed Jun 12 13:14:32 UTC 2019
Modified Files:
src/share/man/man9: audio.9
Log Message:
Describe about get_props() properties.
To generate a diff of this commit:
cvs rdiff -u -r1.54 -r1.55 src/share/man/man9/audio.9
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man9/audio.9
diff -u src/share/man/man9/audio.9:1.54 src/share/man/man9/audio.9:1.55
--- src/share/man/man9/audio.9:1.54 Thu May 9 09:35:18 2019
+++ src/share/man/man9/audio.9 Wed Jun 12 13:14:31 2019
@@ -1,4 +1,4 @@
-.\" $NetBSD: audio.9,v 1.54 2019/05/09 09:35:18 wiz Exp $
+.\" $NetBSD: audio.9,v 1.55 2019/06/12 13:14:31 isaki Exp $
.\"
.\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -496,12 +496,25 @@ which the hardware driver can then chang
E.g., DMA on the ISA bus cannot exceed 65536 bytes.
It is called in the Attached or Closed phases.
.It Dv int get_props(void *hdl)
-Should return the device properties; i.e., a combination of
-AUDIO_PROP_xxx.
-It is called at any time.
+Should return the device properties in a combination of following flags:
+.Pp
+.Bl -tag -width AUDIO_PROP_INDEPENDENT -compact
+.It Dv AUDIO_PROP_PLAYBACK
+the device is capable of audio playback.
+.It Dv AUDIO_PROP_CAPTURE
+the device is capable of audio capture.
+.It Dv AUDIO_PROP_FULLDUPLEX
+the device admits full duplex operation.
+Don't set it if the device is unidirectional.
+.It Dv AUDIO_PROP_INDEPENDENT
+the device can set the playing and recording encoding parameters
+independently.
+Don't set it if the device is unidirectional.
+.It Dv AUDIO_PROP_MMAP
+is handled in the upper layer, so new drivers should not return this property.
+.El
+It is called in the Attach phase.
.Pp
-.Dv AUDIO_PROP_MMAP
-is acceptable but obsolete, so new drivers should not return this property.
.It Dv int trigger_output(void *hdl, void *start, void *end,
.Dv "int blksize, void (*intr)(void*), void *intrarg,"
.Pp
