ioctl VIDIOC_ENCODER_CMD, VIDIOC_TRY_ENCODER_CMD
&manvol;
VIDIOC_ENCODER_CMDVIDIOC_TRY_ENCODER_CMDExecute an encoder commandint ioctlint fdint requeststruct v4l2_encoder_cmd *argpArgumentsfd&fd;requestVIDIOC_ENCODER_CMD, VIDIOC_TRY_ENCODER_CMDargpDescriptionExperimentalThis is an experimental
interface and may change in the future.These ioctls control an audio/video (usually MPEG-) encoder.
VIDIOC_ENCODER_CMD sends a command to the
encoder, VIDIOC_TRY_ENCODER_CMD can be used to
try a command without actually executing it.To send a command applications must initialize all fields of a
&v4l2-encoder-cmd; and call
VIDIOC_ENCODER_CMD or
VIDIOC_TRY_ENCODER_CMD with a pointer to this
structure.The cmd field must contain the
command code. The flags field is currently
only used by the STOP command and contains one bit: If the
V4L2_ENC_CMD_STOP_AT_GOP_END flag is set,
encoding will continue until the end of the current Group
Of Pictures, otherwise it will stop immediately.A read() or &VIDIOC-STREAMON; call sends an implicit
START command to the encoder if it has not been started yet. After a STOP command,
read() calls will read the remaining data
buffered by the driver. When the buffer is empty,
read() will return zero and the next
read() call will restart the encoder.A close() or &VIDIOC-STREAMOFF; call of a streaming
file descriptor sends an implicit immediate STOP to the encoder, and all buffered
data is discarded.These ioctls are optional, not all drivers may support
them. They were introduced in Linux 2.6.21.
struct v4l2_encoder_cmd
&cs-str;
__u32cmdThe encoder command, see .__u32flagsFlags to go with the command, see . If no flags are defined for
this command, drivers and applications must set this field to
zero.__u32data[8]Reserved for future extensions. Drivers and
applications must set the array to zero.
Encoder Commands
&cs-def;
V4L2_ENC_CMD_START0Start the encoder. When the encoder is already
running or paused, this command does nothing. No flags are defined for
this command.V4L2_ENC_CMD_STOP1Stop the encoder. When the
V4L2_ENC_CMD_STOP_AT_GOP_END flag is set,
encoding will continue until the end of the current Group
Of Pictures, otherwise encoding will stop immediately.
When the encoder is already stopped, this command does
nothing.V4L2_ENC_CMD_PAUSE2Pause the encoder. When the encoder has not been
started yet, the driver will return an &EPERM;. When the encoder is
already paused, this command does nothing. No flags are defined for
this command.V4L2_ENC_CMD_RESUME3Resume encoding after a PAUSE command. When the
encoder has not been started yet, the driver will return an &EPERM;.
When the encoder is already running, this command does nothing. No
flags are defined for this command.
Encoder Command Flags
&cs-def;
V4L2_ENC_CMD_STOP_AT_GOP_END0x0001Stop encoding at the end of the current Group Of
Pictures, rather than immediately.
&return-value;
EINVALThe cmd field is invalid.EPERMThe application sent a PAUSE or RESUME command when
the encoder was not running.