1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>snd_jack_set_key</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="The ALSA Driver API"><link rel="up" href="ch08s02.html" title="Jack Abstraction Layer API"><link rel="prev" href="API-snd-jack-set-parent.html" title="snd_jack_set_parent"><link rel="next" href="API-snd-jack-report.html" title="snd_jack_report"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span class="phrase">snd_jack_set_key</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-snd-jack-set-parent.html">Prev</a>&#160;</td><th width="60%" align="center">Jack Abstraction Layer API</th><td width="20%" align="right">&#160;<a accesskey="n" href="API-snd-jack-report.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="API-snd-jack-set-key"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>snd_jack_set_key &#8212; 
2     Set a key mapping on a jack
3 </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">snd_jack_set_key </b>(</code></td><td>struct snd_jack * <var class="pdparam">jack</var>, </td></tr><tr><td>&#160;</td><td>enum snd_jack_types <var class="pdparam">type</var>, </td></tr><tr><td>&#160;</td><td>int <var class="pdparam">keytype</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div></div><div class="refsect1"><a name="idp1096074364"></a><h2>Arguments</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>jack</code></em></span></dt><dd><p>
4     The jack to configure
5    </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
6     Jack report type for this key
7    </p></dd><dt><span class="term"><em class="parameter"><code>keytype</code></em></span></dt><dd><p>
8     Input layer key type to be reported
9    </p></dd></dl></div></div><div class="refsect1"><a name="idp1096078052"></a><h2>Description</h2><p>
10   Map a SND_JACK_BTN_ button type to an input layer key, allowing
11   reporting of keys on accessories via the jack abstraction.  If no
12   mapping is provided but keys are enabled in the jack type then
13   BTN_n numeric buttons will be reported.
14   </p><p>
15
16   If jacks are not reporting via the input API this call will have no
17   effect.
18   </p><p>
19
20   Note that this is intended to be use by simple devices with small
21   numbers of keys that can be reported.  It is also possible to
22   access the input device directly - devices with complex input
23   capabilities on accessories should consider doing this rather than
24   using this abstraction.
25   </p><p>
26
27   This function may only be called prior to registration of the jack.
28</p></div><div class="refsect1"><a name="idp1096079772"></a><h2>Return</h2><p>
29   Zero if successful, or a negative error code on failure.
30</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-snd-jack-set-parent.html">Prev</a>&#160;</td><td width="20%" align="center"><a accesskey="u" href="ch08s02.html">Up</a></td><td width="40%" align="right">&#160;<a accesskey="n" href="API-snd-jack-report.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">snd_jack_set_parent</span>&#160;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&#160;<span class="phrase">snd_jack_report</span></td></tr></table></div></body></html>
31