5.14. ioctl MEDIA_REQUEST_IOC_REINIT¶

5.14.1. Name¶

MEDIA_REQUEST_IOC_REINIT - Re-initialize a request

5.14.2. Synopsis¶

MEDIA_REQUEST_IOC_REINIT¶

int ioctl(int request_fd, MEDIA_REQUEST_IOC_REINIT)

5.14.3. Arguments¶

request_fd: File descriptor returned by ioctl MEDIA_IOC_REQUEST_ALLOC.

5.14.4. Description¶

If the media device supports requests, then this request ioctl can be used to re-initialize a previously allocated request.

Re-initializing a request will clear any existing data from the request. This avoids having to close() a completed request and allocate a new request. Instead the completed request can just be re-initialized and it is ready to be used again.

A request can only be re-initialized if it either has not been queued yet, or if it was queued and completed. Otherwise it will set errno to EBUSY. No other error codes can be returned.

5.14.5. Return Value¶

On success 0 is returned, on error -1 and the errno variable is set appropriately.

EBUSY: The request is queued but not yet completed.