sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftargetB/translations/zh_CN/userspace-api/media/v4l/vidioc-enum-freq-bandsmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetB/translations/zh_TW/userspace-api/media/v4l/vidioc-enum-freq-bandsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetB/translations/it_IT/userspace-api/media/v4l/vidioc-enum-freq-bandsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetB/translations/ja_JP/userspace-api/media/v4l/vidioc-enum-freq-bandsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetB/translations/ko_KR/userspace-api/media/v4l/vidioc-enum-freq-bandsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetB/translations/sp_SP/userspace-api/media/v4l/vidioc-enum-freq-bandsmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-laterh]h8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhh\/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/vidioc-enum-freq-bands.rsthKubhtarget)}(h.. _VIDIOC_ENUM_FREQ_BANDS:h]h}(h]h ]h"]h$]h&]refidvidioc-enum-freq-bandsuh1hhKhhhhhhubhsection)}(hhh](htitle)}(hioctl VIDIOC_ENUM_FREQ_BANDSh]hioctl VIDIOC_ENUM_FREQ_BANDS}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hNameh]hName}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhK ubh paragraph)}(hhjubh }(hjhhhNhNubj)}(h``type``h]htype}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh field. The type must be set to }(hjhhhNhNubj)}(h``V4L2_TUNER_RADIO``h]hV4L2_TUNER_RADIO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh for }(hjhhhNhNubj)}(h``/dev/radioX``h]h /dev/radioX}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh device nodes, and to }(hjhhhNhNubj)}(h``V4L2_TUNER_ANALOG_TV``h]hV4L2_TUNER_ANALOG_TV}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh# for all others. Set this field to }(hjhhhNhNubj)}(h``V4L2_TUNER_RADIO``h]hV4L2_TUNER_RADIO}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhE for modulators (currently only radio modulators are supported). See }(hjhhhNhNubh)}(h:c:type:`v4l2_tuner_type`h]j)}(hj!h]hv4l2_tuner_type}(hj#hhhNhNubah}(h]h ](jjsc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjsreftypetype refexplicitrefwarnjjjv4l2_tuner_typeuh1hhhhK>hjubeh}(h]h ]h"]h$]h&]uh1hhhhK>hjubah}(h]h ]h"]h$]h&]morecolsKuh1j2hj]ubeh}(h]h ]h"]h$]h&]uh1j-hj*ubj.)}(hhh](j3)}(hhh]h)}(h__u32h]h__u32}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKDhjTubah}(h]h ]h"]h$]h&]uh1j2hjQubj3)}(hhh]h)}(h ``index``h]j)}(hjph]hindex}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1hhhhKEhjkubah}(h]h ]h"]h$]h&]uh1j2hjQubj3)}(hhh]h)}(h6Identifies the frequency band, set by the application.h]h6Identifies the frequency band, set by the application.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKFhjubah}(h]h ]h"]h$]h&]morecolsKuh1j2hjQubeh}(h]h ]h"]h$]h&]uh1j-hj*ubj.)}(hhh](j3)}(hhh]h)}(h__u32h]h__u32}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKGhjubah}(h]h ]h"]h$]h&]uh1j2hjubj3)}(hhh]h)}(h``capability``h]j)}(hjh]h capability}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhKHhjubah}(h]h ]h"]h$]h&]uh1j2hjubj3)}(hhh]h)}(hXC:cspan:`2` The tuner/modulator capability flags for this frequency band, see :ref:`tuner-capability`. The ``V4L2_TUNER_CAP_LOW`` or ``V4L2_TUNER_CAP_1HZ`` capability must be the same for all frequency bands of the selected tuner/modulator. So either all bands have that capability set, or none of them have that capability.h](hC The tuner/modulator capability flags for this frequency band, see }(hjhhhNhNubh)}(h:ref:`tuner-capability`h]j)}(hjh]htuner-capability}(hjhhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftyperef refexplicitrefwarnjtuner-capabilityuh1hhhhKIhjubh. The }(hjhhhNhNubj)}(h``V4L2_TUNER_CAP_LOW``h]hV4L2_TUNER_CAP_LOW}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh or }(hjhhhNhNubj)}(h``V4L2_TUNER_CAP_1HZ``h]hV4L2_TUNER_CAP_1HZ}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh capability must be the same for all frequency bands of the selected tuner/modulator. So either all bands have that capability set, or none of them have that capability.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKIhjubah}(h]h ]h"]h$]h&]morecolsKuh1j2hjubeh}(h]h ]h"]h$]h&]uh1j-hj*ubj.)}(hhh](j3)}(hhh]h)}(h__u32h]h__u32}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhjLubah}(h]h ]h"]h$]h&]uh1j2hjIubj3)}(hhh]h)}(h ``rangelow``h]j)}(hjhh]hrangelow}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1hhhhKPhjcubah}(h]h ]h"]h$]h&]uh1j2hjIubj3)}(hhh]h)}(h:cspan:`2` The lowest tunable frequency in units of 62.5 kHz, or if the ``capability`` flag ``V4L2_TUNER_CAP_LOW`` is set, in units of 62.5 Hz, for this frequency band. A 1 Hz unit is used when the ``capability`` flag ``V4L2_TUNER_CAP_1HZ`` is set.h](h> The lowest tunable frequency in units of 62.5 kHz, or if the }(hjhhhNhNubj)}(h``capability``h]h capability}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh flag }(hjhhhNhNubj)}(h``V4L2_TUNER_CAP_LOW``h]hV4L2_TUNER_CAP_LOW}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhT is set, in units of 62.5 Hz, for this frequency band. A 1 Hz unit is used when the }(hjhhhNhNubj)}(h``capability``h]h capability}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh flag }hjsbj)}(h``V4L2_TUNER_CAP_1HZ``h]hV4L2_TUNER_CAP_1HZ}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is set.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKQhjubah}(h]h ]h"]h$]h&]morecolsKuh1j2hjIubeh}(h]h ]h"]h$]h&]uh1j-hj*ubj.)}(hhh](j3)}(hhh]h)}(h__u32h]h__u32}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKUhjubah}(h]h ]h"]h$]h&]uh1j2hjubj3)}(hhh]h)}(h ``rangehigh``h]j)}(hjh]h rangehigh}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhKVhjubah}(h]h ]h"]h$]h&]uh1j2hjubj3)}(hhh]h)}(h:cspan:`2` The highest tunable frequency in units of 62.5 kHz, or if the ``capability`` flag ``V4L2_TUNER_CAP_LOW`` is set, in units of 62.5 Hz, for this frequency band. A 1 Hz unit is used when the ``capability`` flag ``V4L2_TUNER_CAP_1HZ`` is set.h](h? The highest tunable frequency in units of 62.5 kHz, or if the }(hj&hhhNhNubj)}(h``capability``h]h capability}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubh flag }(hj&hhhNhNubj)}(h``V4L2_TUNER_CAP_LOW``h]hV4L2_TUNER_CAP_LOW}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubhT is set, in units of 62.5 Hz, for this frequency band. A 1 Hz unit is used when the }(hj&hhhNhNubj)}(h``capability``h]h capability}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubh flag }hj&sbj)}(h``V4L2_TUNER_CAP_1HZ``h]hV4L2_TUNER_CAP_1HZ}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubh is set.}(hj&hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKWhj#ubah}(h]h ]h"]h$]h&]morecolsKuh1j2hjubeh}(h]h ]h"]h$]h&]uh1j-hj*ubj.)}(hhh](j3)}(hhh]h)}(h__u32h]h__u32}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK[hjubah}(h]h ]h"]h$]h&]uh1j2hjubj3)}(hhh]h)}(h``modulation``h]j)}(hjh]h modulation}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhK\hjubah}(h]h ]h"]h$]h&]uh1j2hjubj3)}(hhh](h)}(h_:cspan:`2` The supported modulation systems of this frequency band. See :ref:`band-modulation`.h](h> The supported modulation systems of this frequency band. See }(hjhhhNhNubh)}(h:ref:`band-modulation`h]j)}(hjh]hband-modulation}(hjhhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftyperef refexplicitrefwarnjband-modulationuh1hhhhK]hjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK]hjubhnote)}(hXCurrently only one modulation system per frequency band is supported. More work will need to be done if multiple modulation systems are possible. Contact the linux-media mailing list (`https://linuxtv.org/lists.php `__) if you need such functionality.h]h)}(hXCurrently only one modulation system per frequency band is supported. More work will need to be done if multiple modulation systems are possible. Contact the linux-media mailing list (`https://linuxtv.org/lists.php `__) if you need such functionality.h](hCurrently only one modulation system per frequency band is supported. More work will need to be done if multiple modulation systems are possible. Contact the linux-media mailing list (}(hjhhhNhNubh reference)}(hA`https://linuxtv.org/lists.php `__h]hhttps://linuxtv.org/lists.php}(hj hhhNhNubah}(h]h ]h"]h$]h&]namehttps://linuxtv.org/lists.phprefurihttps://linuxtv.org/lists.phpuh1j hjubh!) if you need such functionality.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKbhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]morecolsKuh1j2hjubeh}(h]h ]h"]h$]h&]uh1j-hj*ubj.)}(hhh](j3)}(hhh]h)}(h__u32h]h__u32}(hj= hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhj: ubah}(h]h ]h"]h$]h&]uh1j2hj7 ubj3)}(hhh]h)}(h``reserved``\ [9]h](j)}(h ``reserved``h]hreserved}(hjX hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjT ubh [9]}(hjT hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKihjQ ubah}(h]h ]h"]h$]h&]uh1j2hj7 ubj3)}(hhh](h)}(hReserved for future extensions.h]hReserved for future extensions.}(hjy hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKjhjv ubh)}(h4Applications and drivers must set the array to zero.h]h4Applications and drivers must set the array to zero.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKlhjv ubeh}(h]h ]h"]h$]h&]morecolsKuh1j2hj7 ubeh}(h]h ]h"]h$]h&]uh1j-hj*ubeh}(h]h ]h"]h$]h&]uh1j(hjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubeh}(h]id1ah ]h"]h$]h&]uh1jhjhhhNhNubjb)}(hhh]h}(h]h ]h"]h$]h&]jl|p{6.6cm}|p{2.2cm}|p{8.5cm}|uh1jahhhKohjhhubh)}(h.. _band-modulation:h]h}(h]h ]h"]h$]h&]hband-modulationuh1hhKqhjhhhhubj)}(hhh](h)}(hBand Modulation Systemsh]hBand Modulation Systems}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKshj ubj)}(hhh](j)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhj ubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhj ubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhj ubj))}(hhh](j.)}(hhh](j3)}(hhh]h)}(h``V4L2_BAND_MODULATION_VSB``h]j)}(hj h]hV4L2_BAND_MODULATION_VSB}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhhhKxhj ubah}(h]h ]h"]h$]h&]uh1j2hj ubj3)}(hhh]h)}(h0x02h]h0x02}(hj& hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKyhj# ubah}(h]h ]h"]h$]h&]uh1j2hj ubj3)}(hhh]h)}(h2Vestigial Sideband modulation, used for analog TV.h]h2Vestigial Sideband modulation, used for analog TV.}(hj= hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKzhj: ubah}(h]h ]h"]h$]h&]uh1j2hj ubeh}(h]h ]h"]h$]h&]uh1j-hj ubj.)}(hhh](j3)}(hhh]h)}(h``V4L2_BAND_MODULATION_FM``h]j)}(hj_ h]hV4L2_BAND_MODULATION_FM}(hja hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj] ubah}(h]h ]h"]h$]h&]uh1hhhhK{hjZ ubah}(h]h ]h"]h$]h&]uh1j2hjW ubj3)}(hhh]h)}(h0x04h]h0x04}(hj} hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK|hjz ubah}(h]h ]h"]h$]h&]uh1j2hjW ubj3)}(hhh]h)}(h5Frequency Modulation, commonly used for analog radio.h]h5Frequency Modulation, commonly used for analog radio.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK}hj ubah}(h]h ]h"]h$]h&]uh1j2hjW ubeh}(h]h ]h"]h$]h&]uh1j-hj ubj.)}(hhh](j3)}(hhh]h)}(h``V4L2_BAND_MODULATION_AM``h]j)}(hj h]hV4L2_BAND_MODULATION_AM}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhhhK~hj ubah}(h]h ]h"]h$]h&]uh1j2hj ubj3)}(hhh]h)}(h0x08h]h0x08}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j2hj ubj3)}(hhh]h)}(h5Amplitude Modulation, commonly used for analog radio.h]h5Amplitude Modulation, commonly used for analog radio.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j2hj ubeh}(h]h ]h"]h$]h&]uh1j-hj ubeh}(h]h ]h"]h$]h&]uh1j(hj ubeh}(h]h ]h"]h$]h&]colsKuh1jhj ubeh}(h](id2j eh ]h"]band-modulationah$]h&]uh1jhjhhhNhNexpect_referenced_by_name}j j sexpect_referenced_by_id}j j subeh}(h] descriptionah ]h"] descriptionah$]h&]uh1hhhhhhhhK ubh)}(hhh](h)}(h Return Valueh]h Return Value}(hj) hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj& hhhhhKubh)}(hOn success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter.h](h.On success 0 is returned, on error -1 and the }(hj7 hhhNhNubj)}(h ``errno``h]herrno}(hj? hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7 ubhM variable is set appropriately. The generic error codes are described at the }(hj7 hhhNhNubh)}(h':ref:`Generic Error Codes `h]j)}(hjS h]hGeneric Error Codes}(hjU hhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jhjQ ubah}(h]h ]h"]h$]h&]refdocj refdomainj_ reftyperef refexplicitrefwarnj gen-errorsuh1hhhhKhj7 ubh chapter.}(hj7 hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj& hhubj)}(hhh]j)}(hREINVAL The ``tuner`` or ``index`` is out of bounds or the ``type`` field is wrong.h](j)}(hEINVALh]hEINVAL}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhj~ ubj)}(hhh]h)}(hKThe ``tuner`` or ``index`` is out of bounds or the ``type`` field is wrong.h](hThe }(hj hhhNhNubj)}(h ``tuner``h]htuner}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh or }(hj hhhNhNubj)}(h ``index``h]hindex}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh is out of bounds or the }(hj hhhNhNubj)}(h``type``h]htype}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh field is wrong.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj~ ubeh}(h]h ]h"]h$]h&]uh1jhhhKhj{ ubah}(h]h ]h"]h$]h&]uh1jhj& hhhhhNubeh}(h] return-valueah ]h"] return valueah$]h&]uh1hhhhhhhhKubeh}(h](ioctl-vidioc-enum-freq-bandsheh ]h"](ioctl vidioc_enum_freq_bandsvidioc_enum_freq_bandseh$]h&]uh1hhhhhhhhKj }j hsj }hhsubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksj2footnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}(h]haj ]j aunameids}(j hj j hhjjjjj# j j j j j u nametypes}(j j hjjj# j j uh}(hhj hhhjjj j)jjj jjzjj j j j& j jj j u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}j, KsRparse_messages]transform_messages](hsystem_message)}(hhh]h)}(hhh]h