FFmpeg
hwcontext_qsv.h
Go to the documentation of this file.
1 /*
2  * This file is part of FFmpeg.
3  *
4  * FFmpeg is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * FFmpeg is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with FFmpeg; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17  */
18 
19 #ifndef AVUTIL_HWCONTEXT_QSV_H
20 #define AVUTIL_HWCONTEXT_QSV_H
21 
22 #include <mfxvideo.h>
23 
24 /**
25  * @file
26  * An API-specific header for AV_HWDEVICE_TYPE_QSV.
27  *
28  * AVHWFramesContext.pool must contain AVBufferRefs whose data pointer points
29  * to a mfxFrameSurface1 struct.
30  */
31 
32 /**
33  * This struct is allocated as AVHWDeviceContext.hwctx
34  */
35 typedef struct AVQSVDeviceContext {
36  mfxSession session;
37  /**
38  * The mfxLoader handle used for mfxSession creation
39  *
40  * This field is only available for oneVPL user. For non-oneVPL user, this
41  * field must be set to NULL.
42  *
43  * Filled by the user before calling av_hwdevice_ctx_init() and should be
44  * cast to mfxLoader handle. Deallocating the AVHWDeviceContext will always
45  * release this interface.
46  */
47  void *loader;
49 
50 /**
51  * This struct is allocated as AVHWFramesContext.hwctx
52  */
53 typedef struct AVQSVFramesContext {
54  /**
55  * A pointer to a mfxFrameSurface1 struct
56  *
57  * It is available when nb_surfaces is non-zero.
58  */
59  mfxFrameSurface1 *surfaces;
60 
61  /**
62  * Number of frames in the pool
63  *
64  * It is 0 for dynamic frame pools or AVHWFramesContext.initial_pool_size
65  * for fixed frame pools.
66  *
67  * Note only oneVPL GPU runtime 2.9+ can support dynamic frame pools
68  * on d3d11va or vaapi
69  */
71 
72  /**
73  * A combination of MFX_MEMTYPE_* describing the frame pool.
74  */
76 
77  /**
78  * A pointer to a mfxFrameInfo struct
79  *
80  * It is available when nb_surfaces is 0, all buffers allocated from the
81  * pool have the same mfxFrameInfo.
82  */
83  mfxFrameInfo *info;
85 
86 #endif /* AVUTIL_HWCONTEXT_QSV_H */
87 
AVQSVFramesContext::frame_type
int frame_type
A combination of MFX_MEMTYPE_* describing the frame pool.
Definition: hwcontext_qsv.h:75
AVQSVDeviceContext
This struct is allocated as AVHWDeviceContext.hwctx.
Definition: hwcontext_qsv.h:35
AVQSVFramesContext::surfaces
mfxFrameSurface1 * surfaces
A pointer to a mfxFrameSurface1 struct.
Definition: hwcontext_qsv.h:59
AVQSVDeviceContext::loader
void * loader
The mfxLoader handle used for mfxSession creation.
Definition: hwcontext_qsv.h:47
AVQSVFramesContext::nb_surfaces
int nb_surfaces
Number of frames in the pool.
Definition: hwcontext_qsv.h:70
AVQSVFramesContext::info
mfxFrameInfo * info
A pointer to a mfxFrameInfo struct.
Definition: hwcontext_qsv.h:83
AVQSVDeviceContext::session
mfxSession session
Definition: hwcontext_qsv.h:36
AVQSVFramesContext
This struct is allocated as AVHWFramesContext.hwctx.
Definition: hwcontext_qsv.h:53