1<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>v4l2_ctrl_new_std_menu</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="Linux Device Drivers"><link rel="up" href="mediadev.html#id-1.8.2" title="Video2Linux devices"><link rel="prev" href="API-v4l2-ctrl-new-std.html" title="v4l2_ctrl_new_std"><link rel="next" href="API-v4l2-ctrl-new-std-menu-items.html" title="v4l2_ctrl_new_std_menu_items"></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">v4l2_ctrl_new_std_menu</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-v4l2-ctrl-new-std.html">Prev</a> </td><th width="60%" align="center">Video2Linux devices</th><td width="20%" align="right"> <a accesskey="n" href="API-v4l2-ctrl-new-std-menu-items.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="API-v4l2-ctrl-new-std-menu"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>v4l2_ctrl_new_std_menu — 2 Allocate and initialize a new standard V4L2 menu control. 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"><a class="link" href="API-struct-v4l2-ctrl.html" title="struct v4l2_ctrl">struct v4l2_ctrl</a> * <b class="fsfunc">v4l2_ctrl_new_std_menu </b>(</code></td><td><a class="link" href="API-struct-v4l2-ctrl-handler.html" title="struct v4l2_ctrl_handler">struct v4l2_ctrl_handler</a> * <var class="pdparam">hdl</var>, </td></tr><tr><td> </td><td><a class="link" href="API-struct-v4l2-ctrl-ops.html" title="struct v4l2_ctrl_ops">const struct v4l2_ctrl_ops</a> * <var class="pdparam">ops</var>, </td></tr><tr><td> </td><td>u32 <var class="pdparam">id</var>, </td></tr><tr><td> </td><td>u8 <var class="pdparam">max</var>, </td></tr><tr><td> </td><td>u64 <var class="pdparam">mask</var>, </td></tr><tr><td> </td><td>u8 <var class="pdparam">def</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a name="id-1.8.2.28.5"></a><h2>Arguments</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>hdl</code></em></span></dt><dd><p> 4 The control handler. 5 </p></dd><dt><span class="term"><em class="parameter"><code>ops</code></em></span></dt><dd><p> 6 The control ops. 7 </p></dd><dt><span class="term"><em class="parameter"><code>id</code></em></span></dt><dd><p> 8 The control ID. 9 </p></dd><dt><span class="term"><em class="parameter"><code>max</code></em></span></dt><dd><p> 10 The control's maximum value. 11 </p></dd><dt><span class="term"><em class="parameter"><code>mask</code></em></span></dt><dd><p> 12 The control's skip mask for menu controls. This makes it 13 easy to skip menu items that are not valid. If bit X is set, 14 then menu item X is skipped. Of course, this only works for 15 menus with <= 64 menu items. There are no menus that come 16 close to that number, so this is OK. Should we ever need more, 17 then this will have to be extended to a bit array. 18 </p></dd><dt><span class="term"><em class="parameter"><code>def</code></em></span></dt><dd><p> 19 The control's default value. 20 </p></dd></dl></div></div><div class="refsect1"><a name="id-1.8.2.28.6"></a><h2>Description</h2><p> 21 Same as <code class="function"><a class="link" href="API-v4l2-ctrl-new-std.html" title="v4l2_ctrl_new_std">v4l2_ctrl_new_std</a></code>, but <em class="parameter"><code>min</code></em> is set to 0 and the <em class="parameter"><code>mask</code></em> value 22 determines which menu items are to be skipped. 23 </p><p> 24 25 If <em class="parameter"><code>id</code></em> refers to a non-menu control, then this function will return NULL. 26</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-v4l2-ctrl-new-std.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="mediadev.html#id-1.8.2">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-v4l2-ctrl-new-std-menu-items.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">v4l2_ctrl_new_std</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span class="phrase">v4l2_ctrl_new_std_menu_items</span></td></tr></table></div></body></html> 27