video-stillpicture.rst 1.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263
  1. .. -*- coding: utf-8; mode: rst -*-
  2. .. _VIDEO_STILLPICTURE:
  3. ==================
  4. VIDEO_STILLPICTURE
  5. ==================
  6. Name
  7. ----
  8. VIDEO_STILLPICTURE
  9. .. attention:: This ioctl is deprecated.
  10. Synopsis
  11. --------
  12. .. c:function:: int ioctl(fd, VIDEO_STILLPICTURE, struct video_still_picture *sp)
  13. :name: VIDEO_STILLPICTURE
  14. Arguments
  15. ---------
  16. .. flat-table::
  17. :header-rows: 0
  18. :stub-columns: 0
  19. - .. row 1
  20. - int fd
  21. - File descriptor returned by a previous call to open().
  22. - .. row 2
  23. - int request
  24. - Equals VIDEO_STILLPICTURE for this command.
  25. - .. row 3
  26. - struct video_still_picture \*sp
  27. - Pointer to a location where an I-frame and size is stored.
  28. Description
  29. -----------
  30. This ioctl call asks the Video Device to display a still picture
  31. (I-frame). The input data shall contain an I-frame. If the pointer is
  32. NULL, then the current displayed still picture is blanked.
  33. Return Value
  34. ------------
  35. On success 0 is returned, on error -1 and the ``errno`` variable is set
  36. appropriately. The generic error codes are described at the
  37. :ref:`Generic Error Codes <gen-errors>` chapter.