€•ñ9Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ>/translations/zh_CN/userspace-api/media/v4l/vidioc-prepare-buf”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ>/translations/zh_TW/userspace-api/media/v4l/vidioc-prepare-buf”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ>/translations/it_IT/userspace-api/media/v4l/vidioc-prepare-buf”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ>/translations/ja_JP/userspace-api/media/v4l/vidioc-prepare-buf”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ>/translations/ko_KR/userspace-api/media/v4l/vidioc-prepare-buf”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ>/translations/pt_BR/userspace-api/media/v4l/vidioc-prepare-buf”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ>/translations/sp_SP/userspace-api/media/v4l/vidioc-prepare-buf”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later”h]”hŒ8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later”…””}”hh·sbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1hµhhh²hh³ŒX/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/vidioc-prepare-buf.rst”h´KubhŒtarget”“”)”}”(hŒ.. _VIDIOC_PREPARE_BUF:”h]”h}”(h]”h ]”h"]”h$]”h&]”Œrefid”Œvidioc-prepare-buf”uh1hÈh´Khhh²hh³hÇubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒioctl VIDIOC_PREPARE_BUF”h]”hŒioctl VIDIOC_PREPARE_BUF”…””}”(hhÝh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÛhhØh²hh³hÇh´Kubh×)”}”(hhh]”(hÜ)”}”(hŒName”h]”hŒName”…””}”(hhîh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÛhhëh²hh³hÇh´K ubhŒ paragraph”“”)”}”(hŒ-VIDIOC_PREPARE_BUF - Prepare a buffer for I/O”h]”hŒ-VIDIOC_PREPARE_BUF - Prepare a buffer for I/O”…””}”(hhþh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´K hhëh²hubeh}”(h]”Œname”ah ]”h"]”Œname”ah$]”h&]”uh1hÖhhØh²hh³hÇh´K ubh×)”}”(hhh]”(hÜ)”}”(hŒSynopsis”h]”hŒSynopsis”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÛhjh²hh³hÇh´KubhŒindex”“”)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(Œsingle”Œ V4L.VIDIOC_PREPARE_BUF (C macro)”Œc.V4L.VIDIOC_PREPARE_BUF”hNt”auh1j%hjh²hh³Nh´NubhŒdesc”“”)”}”(hhh]”(hŒdesc_signature”“”)”}”(hŒVIDIOC_PREPARE_BUF”h]”hŒdesc_signature_line”“”)”}”(hŒVIDIOC_PREPARE_BUF”h]”hŒ desc_name”“”)”}”(hŒVIDIOC_PREPARE_BUF”h]”hŒ desc_sig_name”“”)”}”(hj?h]”hŒVIDIOC_PREPARE_BUF”…””}”(hjOh²hh³Nh´Nubah}”(h]”h ]”Œn”ah"]”h$]”h&]”uh1jMhjIubah}”(h]”h ]”(Œsig-name”Œdescname”eh"]”h$]”h&]”hÅhÆuh1jGhjCh²hh³hÇh´Kubah}”(h]”h ]”h"]”h$]”h&]”hÅhÆŒ add_permalink”ˆuh1jAŒsphinx_line_type”Œ declarator”hj=h²hh³hÇh´Kubah}”(h]”j4ah ]”(Œsig”Œ sig-object”eh"]”h$]”h&]”Œ is_multiline”ˆŒ _toc_parts”)Œ _toc_name”huh1j;h³hÇh´Khj8h²hubhŒ desc_content”“”)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”uh1jyhj8h²hh³hÇh´Kubeh}”(h]”h ]”(Œc”Œmacro”eh"]”h$]”h&]”Œdomain”j‡Œobjtype”jˆŒdesctype”jˆŒnoindex”‰Œ noindexentry”‰Œnocontentsentry”‰uh1j6h²hhjh³Nh´Nubhý)”}”(hŒC``int ioctl(int fd, VIDIOC_PREPARE_BUF, struct v4l2_buffer *argp)``”h]”hŒliteral”“”)”}”(hj”h]”hŒ?int ioctl(int fd, VIDIOC_PREPARE_BUF, struct v4l2_buffer *argp)”…””}”(hj˜h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j–hj’ubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´Khjh²hubeh}”(h]”Œsynopsis”ah ]”h"]”Œsynopsis”ah$]”h&]”uh1hÖhhØh²hh³hÇh´Kubh×)”}”(hhh]”(hÜ)”}”(hŒ Arguments”h]”hŒ Arguments”…””}”(hj¶h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÛhj³h²hh³hÇh´KubhŒdefinition_list”“”)”}”(hhh]”(hŒdefinition_list_item”“”)”}”(hŒ5``fd`` File descriptor returned by :c:func:`open()`. ”h]”(hŒterm”“”)”}”(hŒ``fd``”h]”j—)”}”(hjÓh]”hŒfd”…””}”(hjÕh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j–hjÑubah}”(h]”h ]”h"]”h$]”h&]”uh1jÏh³hÇh´KhjËubhŒ definition”“”)”}”(hhh]”hý)”}”(hŒ-File descriptor returned by :c:func:`open()`.”h]”(hŒFile descriptor returned by ”…””}”(hjíh²hh³Nh´Nubh)”}”(hŒ:c:func:`open()`”h]”j—)”}”(hj÷h]”hŒopen()”…””}”(hjùh²hh³Nh´Nubah}”(h]”h ]”(Œxref”j‡Œc-func”eh"]”h$]”h&]”uh1j–hjõubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”Œ*userspace-api/media/v4l/vidioc-prepare-buf”Œ refdomain”j‡Œreftype”Œfunc”Œ refexplicit”‰Œrefwarn”‰Œ c:parent_key”Œsphinx.domains.c”Œ LookupKey”“”)”}”Œdata”]”jŒ ASTIdentifier”“”)”}”Œ identifier”ŒV4L”sbN†”asbŒ reftarget”Œopen”uh1hh³hÇh´KhjíubhŒ.”…””}”(hjíh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´Khjêubah}”(h]”h ]”h"]”h$]”h&]”uh1jèhjËubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÉh³hÇh´KhjÆubjÊ)”}”(hŒ2``argp`` Pointer to struct :c:type:`v4l2_buffer`. ”h]”(jÐ)”}”(hŒ``argp``”h]”j—)”}”(hjBh]”hŒargp”…””}”(hjDh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j–hj@ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÏh³hÇh´Khj<ubjé)”}”(hhh]”hý)”}”(hŒ(Pointer to struct :c:type:`v4l2_buffer`.”h]”(hŒPointer to struct ”…””}”(hjZh²hh³Nh´Nubh)”}”(hŒ:c:type:`v4l2_buffer`”h]”j—)”}”(hjdh]”hŒ v4l2_buffer”…””}”(hjfh²hh³Nh´Nubah}”(h]”h ]”(jj‡Œc-type”eh"]”h$]”h&]”uh1j–hjbubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”jŒ refdomain”j‡Œreftype”Œtype”Œ refexplicit”‰Œrefwarn”‰jjj$Œ v4l2_buffer”uh1hh³hÇh´KhjZubhŒ.”…””}”(hjZh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´KhjWubah}”(h]”h ]”h"]”h$]”h&]”uh1jèhj<ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÉh³hÇh´KhjÆh²hubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÄhj³h²hh³hÇh´Nubeh}”(h]”Œ arguments”ah ]”h"]”Œ arguments”ah$]”h&]”uh1hÖhhØh²hh³hÇh´Kubh×)”}”(hhh]”(hÜ)”}”(hŒ Description”h]”hŒ Description”…””}”(hj¨h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÛhj¥h²hh³hÇh´K ubhý)”}”(hX_Applications can optionally call the :ref:`VIDIOC_PREPARE_BUF` ioctl to pass ownership of the buffer to the driver before actually enqueuing it, using the :ref:`VIDIOC_QBUF ` ioctl, and to prepare it for future I/O. Such preparations may include cache invalidation or cleaning. Performing them in advance saves time during the actual I/O.”h]”(hŒ%Applications can optionally call the ”…””}”(hj¶h²hh³Nh´Nubh)”}”(hŒ:ref:`VIDIOC_PREPARE_BUF`”h]”hŒinline”“”)”}”(hjÀh]”hŒVIDIOC_PREPARE_BUF”…””}”(hjÄh²hh³Nh´Nubah}”(h]”h ]”(jŒstd”Œstd-ref”eh"]”h$]”h&]”uh1jÂhj¾ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”jŒ refdomain”jÎŒreftype”Œref”Œ refexplicit”‰Œrefwarn”ˆj$Œvidioc_prepare_buf”uh1hh³hÇh´K"hj¶ubhŒ] ioctl to pass ownership of the buffer to the driver before actually enqueuing it, using the ”…””}”(hj¶h²hh³Nh´Nubh)”}”(hŒ :ref:`VIDIOC_QBUF `”h]”jÃ)”}”(hjæh]”hŒ VIDIOC_QBUF”…””}”(hjèh²hh³Nh´Nubah}”(h]”h ]”(jŒstd”Œstd-ref”eh"]”h$]”h&]”uh1jÂhjäubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”jŒ refdomain”jòŒreftype”Œref”Œ refexplicit”ˆŒrefwarn”ˆj$Œ vidioc_qbuf”uh1hh³hÇh´K"hj¶ubhŒ¤ ioctl, and to prepare it for future I/O. Such preparations may include cache invalidation or cleaning. Performing them in advance saves time during the actual I/O.”…””}”(hj¶h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´K"hj¥h²hubhý)”}”(hŒIThe struct :c:type:`v4l2_buffer` structure is specified in :ref:`buffer`.”h]”(hŒ The struct ”…””}”(hjh²hh³Nh´Nubh)”}”(hŒ:c:type:`v4l2_buffer`”h]”j—)”}”(hjh]”hŒ v4l2_buffer”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”(jj‡Œc-type”eh"]”h$]”h&]”uh1j–hjubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”jŒ refdomain”j‡Œreftype”Œtype”Œ refexplicit”‰Œrefwarn”‰jjj$Œ v4l2_buffer”uh1hh³hÇh´K(hjubhŒ structure is specified in ”…””}”(hjh²hh³Nh´Nubh)”}”(hŒ :ref:`buffer`”h]”jÃ)”}”(hj;h]”hŒbuffer”…””}”(hj=h²hh³Nh´Nubah}”(h]”h ]”(jŒstd”Œstd-ref”eh"]”h$]”h&]”uh1jÂhj9ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”jŒ refdomain”jGŒreftype”Œref”Œ refexplicit”‰Œrefwarn”ˆj$Œbuffer”uh1hh³hÇh´K(hjubhŒ.”…””}”(hjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´K(hj¥h²hubeh}”(h]”Œ description”ah ]”h"]”Œ description”ah$]”h&]”uh1hÖhhØh²hh³hÇh´K ubh×)”}”(hhh]”(hÜ)”}”(hŒ Return Value”h]”hŒ Return Value”…””}”(hjnh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÛhjkh²hh³hÇh´K,ubhý)”}”(hŒ´On 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 ”…””}”(hj|h²hh³Nh´Nubj—)”}”(hŒ ``errno``”h]”hŒerrno”…””}”(hj„h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j–hj|ubhŒM variable is set appropriately. The generic error codes are described at the ”…””}”(hj|h²hh³Nh´Nubh)”}”(hŒ':ref:`Generic Error Codes `”h]”jÃ)”}”(hj˜h]”hŒGeneric Error Codes”…””}”(hjšh²hh³Nh´Nubah}”(h]”h ]”(jŒstd”Œstd-ref”eh"]”h$]”h&]”uh1jÂhj–ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”jŒ refdomain”j¤Œreftype”Œref”Œ refexplicit”ˆŒrefwarn”ˆj$Œ gen-errors”uh1hh³hÇh´K.hj|ubhŒ chapter.”…””}”(hj|h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´K.hjkh²hubjÅ)”}”(hhh]”(jÊ)”}”(hŒEBUSY File I/O is in progress. ”h]”(jÐ)”}”(hŒEBUSY”h]”hŒEBUSY”…””}”(hjÇh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÏh³hÇh´K3hjÃubjé)”}”(hhh]”hý)”}”(hŒFile I/O is in progress.”h]”hŒFile I/O is in progress.”…””}”(hjØh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´K3hjÕubah}”(h]”h ]”h"]”h$]”h&]”uh1jèhjÃubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÉh³hÇh´K3hjÀubjÊ)”}”(hŒ¤EINVAL The buffer ``type`` is not supported, or the ``index`` is out of bounds, or no buffers have been allocated yet, or the ``userptr`` or ``length`` are invalid.”h]”(jÐ)”}”(hŒEINVAL”h]”hŒEINVAL”…””}”(hjöh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÏh³hÇh´K7hjòubjé)”}”(hhh]”hý)”}”(hŒThe buffer ``type`` is not supported, or the ``index`` is out of bounds, or no buffers have been allocated yet, or the ``userptr`` or ``length`` are invalid.”h]”(hŒ The buffer ”…””}”(hjh²hh³Nh´Nubj—)”}”(hŒ``type``”h]”hŒtype”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j–hjubhŒ is not supported, or the ”…””}”(hjh²hh³Nh´Nubj—)”}”(hŒ ``index``”h]”hŒindex”…””}”(hj!h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j–hjubhŒA is out of bounds, or no buffers have been allocated yet, or the ”…””}”(hjh²hh³Nh´Nubj—)”}”(hŒ ``userptr``”h]”hŒuserptr”…””}”(hj3h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j–hjubhŒ or ”…””}”(hjh²hh³Nh´Nubj—)”}”(hŒ ``length``”h]”hŒlength”…””}”(hjEh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j–hjubhŒ are invalid.”…””}”(hjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´K6hjubah}”(h]”h ]”h"]”h$]”h&]”uh1jèhjòubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÉh³hÇh´K7hjÀh²hubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÄhjkh²hh³hÇh´Nubeh}”(h]”Œ return-value”ah ]”h"]”Œ return value”ah$]”h&]”uh1hÖhhØh²hh³hÇh´K,ubeh}”(h]”(Œioctl-vidioc-prepare-buf”hÕeh ]”h"]”(Œioctl vidioc_prepare_buf”Œvidioc_prepare_buf”eh$]”h&]”uh1hÖhhh²hh³hÇh´KŒexpect_referenced_by_name”}”j}hÊsŒexpect_referenced_by_id”}”hÕhÊsubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÇuh1hŒcurrent_source”NŒ current_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hÛNŒ generator”NŒ datestamp”NŒ source_link”NŒ source_url”NŒ toc_backlinks”Œentry”Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒ report_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j§Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÇŒ _destination”NŒ _config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒ raw_enabled”KŒline_length_limit”M'Œpep_references”NŒ pep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒ rfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œ smart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œ image_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”hÕ]”hÊasŒnameids”}”(j}hÕj|jyjjj°j­j¢jŸjhjejtjquŒ nametypes”}”(j}ˆj|‰j‰j°‰j¢‰jh‰jt‰uh}”(hÕhØjyhØjhëj­jj4j=jŸj³jej¥jqjkuŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œ collections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”hŒsystem_message”“”)”}”(hhh]”hý)”}”(hhh]”hŒ8Hyperlink target "vidioc-prepare-buf" is not referenced.”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”uh1hühjubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”hÇŒline”Kuh1j ubaŒ transformer”NŒ include_log”]”Œ decoration”Nh²hub.