<?xml version="1.0" encoding="ANSI_X3.4-1968" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968" /><title>snd_ctl_new1</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="The ALSA Driver API" /><link rel="up" href="ch03.html#id2712852" title="General Control Interface" /><link rel="prev" href="ch03.html" title="Chapter 3. Control/Mixer API" /><link rel="next" href="re68.html" title="snd_ctl_free_one" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span>snd_ctl_new1</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03.html">Prev</a> </td><th width="60%" align="center">General Control Interface</th><td width="20%" align="right"> <a accesskey="n" href="re68.html">Next</a></td></tr></table><hr /></div><div class="refentry" title="snd_ctl_new1"><a id="API-snd-ctl-new1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>snd_ctl_new1 —
create a control instance from the template
</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">struct snd_kcontrol * <b class="fsfunc">snd_ctl_new1 </b>(</code></td><td>const struct snd_kcontrol_new * <var class="pdparam">ncontrol</var>, </td></tr><tr><td> </td><td>void * <var class="pdparam">private_data</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1" title="Arguments"><a id="id2712937"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ncontrol</code></em></span></dt><dd><p>
the initialization record
</p></dd><dt><span class="term"><em class="parameter"><code>private_data</code></em></span></dt><dd><p>
the private data to set
</p></dd></dl></div></div><div class="refsect1" title="Description"><a id="id2712980"></a><h2>Description</h2><p>
Allocates a new struct snd_kcontrol instance and initialize from the given
template. When the access field of ncontrol is 0, it's assumed as
READWRITE access. When the count field is 0, it's assumes as one.
</p><p>
Returns the pointer of the newly generated instance, or NULL on failure.
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch03.html#id2712852">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="re68.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 3. Control/Mixer API </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>snd_ctl_free_one</span></td></tr></table></div></body></html>
