[src/trunk]: src/share/man/man9 Describe about get_props() properties.

[isaki <isaki%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/5454b8ef8139
branches:  trunk
changeset: 451940:5454b8ef8139
user:      isaki <isaki%NetBSD.org@localhost>
date:      Wed Jun 12 13:14:31 2019 +0000

description:
Describe about get_props() properties.

diffstat:

 share/man/man9/audio.9 |  25 +++++++++++++++++++------
 1 files changed, 19 insertions(+), 6 deletions(-)

diffs (40 lines):

diff -r 17d2bb7223b4 -r 5454b8ef8139 share/man/man9/audio.9
--- a/share/man/man9/audio.9    Wed Jun 12 12:32:54 2019 +0000
+++ b/share/man/man9/audio.9    Wed Jun 12 13:14:31 2019 +0000
@@ -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 @@
 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
-.Dv AUDIO_PROP_MMAP
-is acceptable but obsolete, so new drivers should not return this property.
+.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
 .It Dv int trigger_output(void *hdl, void *start, void *end,
 .Dv "int blksize, void (*intr)(void*), void *intrarg,"
 .Pp