From a853a5d294c3847fccc22ba0655335f64f13ce16 Mon Sep 17 00:00:00 2001 From: Anton Khirnov Date: Thu, 19 May 2016 15:59:25 +0200 Subject: hwcontext: add a function for opening devices --- libavutil/hwcontext.h | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) (limited to 'libavutil/hwcontext.h') diff --git a/libavutil/hwcontext.h b/libavutil/hwcontext.h index 505b1748be..d8e7c3f090 100644 --- a/libavutil/hwcontext.h +++ b/libavutil/hwcontext.h @@ -241,6 +241,34 @@ AVBufferRef *av_hwdevice_ctx_alloc(enum AVHWDeviceType type); */ int av_hwdevice_ctx_init(AVBufferRef *ref); +/** + * Open a device of the specified type and create an AVHWDeviceContext for it. + * + * This is a convenience function intended to cover the simple cases. Callers + * who need to fine-tune device creation/management should open the device + * manually and then wrap it in an AVHWDeviceContext using + * av_hwdevice_ctx_alloc()/av_hwdevice_ctx_init(). + * + * The returned context is already initialized and ready for use, the caller + * should not call av_hwdevice_ctx_init() on it. The user_opaque/free fields of + * the created AVHWDeviceContext are set by this function and should not be + * touched by the caller. + * + * @param device_ctx On success, a reference to the newly-created device context + * will be written here. The reference is owned by the caller + * and must be released with av_buffer_unref() when no longer + * needed. On failure, NULL will be written to this pointer. + * @param type The type of the device to create. + * @param device A type-specific string identifying the device to open. + * @param opts A dictionary of additional (type-specific) options to use in + * opening the device. The dictionary remains owned by the caller. + * @param flags currently unused + * + * @return 0 on success, a negative AVERROR code on failure. + */ +int av_hwdevice_ctx_create(AVBufferRef **device_ctx, enum AVHWDeviceType type, + const char *device, AVDictionary *opts, int flags); + /** * Allocate an AVHWFramesContext tied to a given device context. * -- cgit v1.2.3