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]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetB/translations/pt_BR/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)}(hubjB)}(hhh](jG)}(hhh]h)}(h__u32h]h__u32}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubh }(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)}(hj5h]hv4l2_tuner_type}(hj7hhhNhNubah}(h]h ](jjc-typeeh"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]refdocj refdomainjreftypetype refexplicitrefwarnjjj$v4l2_tuner_typeuh1hhhhK>hjubeh}(h]h ]h"]h$]h&]uh1hhhhK>hjubah}(h]h ]h"]h$]h&]morecolsKuh1jFhjqubeh}(h]h ]h"]h$]h&]uh1jAhj>ubjB)}(hhh](jG)}(hhh]h)}(h__u32h]h__u32}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKDhjhubah}(h]h ]h"]h$]h&]uh1jFhjeubjG)}(hhh]h)}(h ``index``h]j)}(hjh]hindex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhKEhjubah}(h]h ]h"]h$]h&]uh1jFhjeubjG)}(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&]morecolsKuh1jFhjeubeh}(h]h ]h"]h$]h&]uh1jAhj>ubjB)}(hhh](jG)}(hhh]h)}(h__u32h]h__u32}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKGhjubah}(h]h ]h"]h$]h&]uh1jFhjubjG)}(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&]uh1jFhjubjG)}(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&]uh1j-hjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftyperef refexplicitrefwarnj$tuner-capabilityuh1hhhhKIhjubh. The }(hjhhhNhNubj)}(h``V4L2_TUNER_CAP_LOW``h]hV4L2_TUNER_CAP_LOW}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh or }(hjhhhNhNubj)}(h``V4L2_TUNER_CAP_1HZ``h]hV4L2_TUNER_CAP_1HZ}(hj8hhhNhNubah}(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&]morecolsKuh1jFhjubeh}(h]h ]h"]h$]h&]uh1jAhj>ubjB)}(hhh](jG)}(hhh]h)}(h__u32h]h__u32}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhj`ubah}(h]h ]h"]h$]h&]uh1jFhj]ubjG)}(hhh]h)}(h ``rangelow``h]j)}(hj|h]hrangelow}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1hhhhKPhjwubah}(h]h ]h"]h$]h&]uh1jFhj]ubjG)}(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&]morecolsKuh1jFhj]ubeh}(h]h ]h"]h$]h&]uh1jAhj>ubjB)}(hhh](jG)}(hhh]h)}(h__u32h]h__u32}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKUhjubah}(h]h ]h"]h$]h&]uh1jFhjubjG)}(hhh]h)}(h ``rangehigh``h]j)}(hjh]h rangehigh}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhKVhjubah}(h]h ]h"]h$]h&]uh1jFhjubjG)}(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}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubh flag }(hj:hhhNhNubj)}(h``V4L2_TUNER_CAP_LOW``h]hV4L2_TUNER_CAP_LOW}(hjThhhNhNubah}(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}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubh flag }hj:sbj)}(h``V4L2_TUNER_CAP_1HZ``h]hV4L2_TUNER_CAP_1HZ}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubh is set.}(hj:hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKWhj7ubah}(h]h ]h"]h$]h&]morecolsKuh1jFhjubeh}(h]h ]h"]h$]h&]uh1jAhj>ubjB)}(hhh](jG)}(hhh]h)}(h__u32h]h__u32}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK[hjubah}(h]h ]h"]h$]h&]uh1jFhjubjG)}(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&]uh1jFhjubjG)}(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&]uh1j-hjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftyperef refexplicitrefwarnj$band-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 (}(hj hhhNhNubh 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 hj ubh!) if you need such functionality.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKbhj ubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]morecolsKuh1jFhjubeh}(h]h ]h"]h$]h&]uh1jAhj>ubjB)}(hhh](jG)}(hhh]h)}(h__u32h]h__u32}(hjQ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhjN ubah}(h]h ]h"]h$]h&]uh1jFhjK ubjG)}(hhh]h)}(h``reserved``\ [9]h](j)}(h ``reserved``h]hreserved}(hjl hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjh ubh [9]}(hjh hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKihje ubah}(h]h ]h"]h$]h&]uh1jFhjK ubjG)}(hhh](h)}(hReserved for future extensions.h]hReserved for future extensions.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKjhj 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&]uh1hhhhKlhj ubeh}(h]h ]h"]h$]h&]morecolsKuh1jFhjK ubeh}(h]h ]h"]h$]h&]uh1jAhj>ubeh}(h]h ]h"]h$]h&]uh1j<hjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubeh}(h]id1ah ]h"]h$]h&]uh1jhjhhhNhNubjv)}(hhh]h}(h]h ]h"]h$]h&]j|p{6.6cm}|p{2.2cm}|p{8.5cm}|uh1juhhhKohjhhubh)}(h.. _band-modulation:h]h}(h]h ]h"]h$]h&]hԌband-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](jB)}(hhh](jG)}(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&]uh1jFhj ubjG)}(hhh]h)}(h0x02h]h0x02}(hj: hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKyhj7 ubah}(h]h ]h"]h$]h&]uh1jFhj ubjG)}(hhh]h)}(h2Vestigial Sideband modulation, used for analog TV.h]h2Vestigial Sideband modulation, used for analog TV.}(hjQ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKzhjN ubah}(h]h ]h"]h$]h&]uh1jFhj ubeh}(h]h ]h"]h$]h&]uh1jAhj ubjB)}(hhh](jG)}(hhh]h)}(h``V4L2_BAND_MODULATION_FM``h]j)}(hjs h]hV4L2_BAND_MODULATION_FM}(hju hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjq ubah}(h]h ]h"]h$]h&]uh1hhhhK{hjn ubah}(h]h ]h"]h$]h&]uh1jFhjk ubjG)}(hhh]h)}(h0x04h]h0x04}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK|hj ubah}(h]h ]h"]h$]h&]uh1jFhjk ubjG)}(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&]uh1jFhjk ubeh}(h]h ]h"]h$]h&]uh1jAhj ubjB)}(hhh](jG)}(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&]uh1jFhj ubjG)}(hhh]h)}(h0x08h]h0x08}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jFhj ubjG)}(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&]uh1jFhj ubeh}(h]h ]h"]h$]h&]uh1jAhj 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 }(hjK hhhNhNubj)}(h ``errno``h]herrno}(hjS hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjK ubhM variable is set appropriately. The generic error codes are described at the }(hjK hhhNhNubh)}(h':ref:`Generic Error Codes `h]j.)}(hjg h]hGeneric Error Codes}(hji hhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1j-hje ubah}(h]h ]h"]h$]h&]refdocj refdomainjs reftyperef refexplicitrefwarnj$ gen-errorsuh1hhhhKhjK ubh chapter.}(hjK 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 hsj0 }hhsubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksjFfootnote_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_handlerj2 error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _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 jjjjjjj7 j4 j+ j j j u nametypes}(j j jjjj7 j+ j uh}(hhj hjhjjj4j=jjj4 jjjj 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