FFmpeg
mf_utils.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 AVCODEC_MF_UTILS_H
20 #define AVCODEC_MF_UTILS_H
21 
22 #include <windows.h>
23 #include <initguid.h>
24 #ifdef _MSC_VER
25 // The official way of including codecapi (via dshow.h) makes the ICodecAPI
26 // interface unavailable in UWP mode, but including icodecapi.h + codecapi.h
27 // seems to be equivalent. (These headers conflict with the official way
28 // of including it though, through strmif.h via dshow.h. And on mingw, the
29 // mf*.h headers below indirectly include strmif.h.)
30 #include <icodecapi.h>
31 #else
32 #include <dshow.h>
33 // Older versions of mingw-w64 need codecapi.h explicitly included, while newer
34 // ones include it implicitly from dshow.h (via uuids.h).
35 #include <codecapi.h>
36 #endif
37 #include <mfapi.h>
38 #include <mferror.h>
39 #include <mfobjects.h>
40 #include <mftransform.h>
41 
42 #include "avcodec.h"
43 
44 // These functions do exist in mfapi.h, but are only available within
45 // __cplusplus ifdefs.
46 HRESULT ff_MFGetAttributeSize(IMFAttributes *pattr, REFGUID guid,
47  UINT32 *pw, UINT32 *ph);
48 HRESULT ff_MFSetAttributeSize(IMFAttributes *pattr, REFGUID guid,
49  UINT32 uw, UINT32 uh);
50 #define ff_MFSetAttributeRatio ff_MFSetAttributeSize
51 #define ff_MFGetAttributeRatio ff_MFGetAttributeSize
52 
53 // MFTEnumEx was missing from mingw-w64's mfplat import library until
54 // mingw-w64 v6.0.0, thus wrap it and load it using GetProcAddress.
55 // It's also missing in Windows Vista's mfplat.dll.
56 HRESULT ff_MFTEnumEx(GUID guidCategory, UINT32 Flags,
57  const MFT_REGISTER_TYPE_INFO *pInputType,
58  const MFT_REGISTER_TYPE_INFO *pOutputType,
59  IMFActivate ***pppMFTActivate, UINT32 *pnumMFTActivate);
60 
61 
62 // These do exist in mingw-w64's codecapi.h, but they aren't properly defined
63 // by the header until after mingw-w64 v7.0.0.
64 DEFINE_GUID(ff_CODECAPI_AVDecVideoThumbnailGenerationMode, 0x2efd8eee,0x1150,0x4328,0x9c,0xf5,0x66,0xdc,0xe9,0x33,0xfc,0xf4);
65 DEFINE_GUID(ff_CODECAPI_AVDecVideoDropPicWithMissingRef, 0xf8226383,0x14c2,0x4567,0x97,0x34,0x50,0x04,0xe9,0x6f,0xf8,0x87);
66 DEFINE_GUID(ff_CODECAPI_AVDecVideoSoftwareDeinterlaceMode, 0x0c08d1ce,0x9ced,0x4540,0xba,0xe3,0xce,0xb3,0x80,0x14,0x11,0x09);
67 DEFINE_GUID(ff_CODECAPI_AVDecVideoFastDecodeMode, 0x6b529f7d,0xd3b1,0x49c6,0xa9,0x99,0x9e,0xc6,0x91,0x1b,0xed,0xbf);
68 DEFINE_GUID(ff_CODECAPI_AVLowLatencyMode, 0x9c27891a,0xed7a,0x40e1,0x88,0xe8,0xb2,0x27,0x27,0xa0,0x24,0xee);
69 DEFINE_GUID(ff_CODECAPI_AVDecVideoH264ErrorConcealment, 0xececace8,0x3436,0x462c,0x92,0x94,0xcd,0x7b,0xac,0xd7,0x58,0xa9);
70 DEFINE_GUID(ff_CODECAPI_AVDecVideoMPEG2ErrorConcealment, 0x9d2bfe18,0x728d,0x48d2,0xb3,0x58,0xbc,0x7e,0x43,0x6c,0x66,0x74);
71 DEFINE_GUID(ff_CODECAPI_AVDecVideoCodecType, 0x434528e5,0x21f0,0x46b6,0xb6,0x2c,0x9b,0x1b,0x6b,0x65,0x8c,0xd1);
72 DEFINE_GUID(ff_CODECAPI_AVDecVideoDXVAMode, 0xf758f09e,0x7337,0x4ae7,0x83,0x87,0x73,0xdc,0x2d,0x54,0xe6,0x7d);
73 DEFINE_GUID(ff_CODECAPI_AVDecVideoDXVABusEncryption, 0x42153c8b,0xfd0b,0x4765,0xa4,0x62,0xdd,0xd9,0xe8,0xbc,0xc3,0x88);
74 DEFINE_GUID(ff_CODECAPI_AVDecVideoSWPowerLevel, 0xfb5d2347,0x4dd8,0x4509,0xae,0xd0,0xdb,0x5f,0xa9,0xaa,0x93,0xf4);
75 DEFINE_GUID(ff_CODECAPI_AVDecVideoMaxCodedWidth, 0x5ae557b8,0x77af,0x41f5,0x9f,0xa6,0x4d,0xb2,0xfe,0x1d,0x4b,0xca);
76 DEFINE_GUID(ff_CODECAPI_AVDecVideoMaxCodedHeight, 0x7262a16a,0xd2dc,0x4e75,0x9b,0xa8,0x65,0xc0,0xc6,0xd3,0x2b,0x13);
77 DEFINE_GUID(ff_CODECAPI_AVDecNumWorkerThreads, 0x9561c3e8,0xea9e,0x4435,0x9b,0x1e,0xa9,0x3e,0x69,0x18,0x94,0xd8);
78 DEFINE_GUID(ff_CODECAPI_AVDecSoftwareDynamicFormatChange, 0x862e2f0a,0x507b,0x47ff,0xaf,0x47,0x01,0xe2,0x62,0x42,0x98,0xb7);
79 DEFINE_GUID(ff_CODECAPI_AVDecDisableVideoPostProcessing, 0xf8749193,0x667a,0x4f2c,0xa9,0xe8,0x5d,0x4a,0xf9,0x24,0xf0,0x8f);
80 
81 // These are missing from mingw-w64's headers until after mingw-w64 v7.0.0.
82 DEFINE_GUID(ff_CODECAPI_AVEncCommonRateControlMode, 0x1c0608e9, 0x370c, 0x4710, 0x8a, 0x58, 0xcb, 0x61, 0x81, 0xc4, 0x24, 0x23);
83 DEFINE_GUID(ff_CODECAPI_AVEncCommonQuality, 0xfcbf57a3, 0x7ea5, 0x4b0c, 0x96, 0x44, 0x69, 0xb4, 0x0c, 0x39, 0xc3, 0x91);
84 DEFINE_GUID(ff_CODECAPI_AVEncCommonMeanBitRate, 0xf7222374, 0x2144, 0x4815, 0xb5, 0x50, 0xa3, 0x7f, 0x8e, 0x12, 0xee, 0x52);
85 DEFINE_GUID(ff_CODECAPI_AVEncH264CABACEnable, 0xee6cad62, 0xd305, 0x4248, 0xa5, 0xe, 0xe1, 0xb2, 0x55, 0xf7, 0xca, 0xf8);
86 DEFINE_GUID(ff_CODECAPI_AVEncVideoForceKeyFrame, 0x398c1b98, 0x8353, 0x475a, 0x9e, 0xf2, 0x8f, 0x26, 0x5d, 0x26, 0x3, 0x45);
87 DEFINE_GUID(ff_CODECAPI_AVEncMPVDefaultBPictureCount, 0x8d390aac, 0xdc5c, 0x4200, 0xb5, 0x7f, 0x81, 0x4d, 0x04, 0xba, 0xba, 0xb2);
88 DEFINE_GUID(ff_CODECAPI_AVScenarioInfo, 0xb28a6e64,0x3ff9,0x446a,0x8a,0x4b,0x0d,0x7a,0x53,0x41,0x32,0x36);
89 
90 DEFINE_GUID(ff_MF_SA_D3D11_BINDFLAGS, 0xeacf97ad, 0x065c, 0x4408, 0xbe, 0xe3, 0xfd, 0xcb, 0xfd, 0x12, 0x8b, 0xe2);
91 DEFINE_GUID(ff_MF_SA_D3D11_USAGE, 0xe85fe442, 0x2ca3, 0x486e, 0xa9, 0xc7, 0x10, 0x9d, 0xda, 0x60, 0x98, 0x80);
92 DEFINE_GUID(ff_MF_SA_D3D11_AWARE, 0x206b4fc8, 0xfcf9, 0x4c51, 0xaf, 0xe3, 0x97, 0x64, 0x36, 0x9e, 0x33, 0xa0);
93 DEFINE_GUID(ff_MF_SA_D3D11_SHARED, 0x7b8f32c3, 0x6d96, 0x4b89, 0x92, 0x3, 0xdd, 0x38, 0xb6, 0x14, 0x14, 0xf3);
94 DEFINE_GUID(ff_MF_SA_D3D11_SHARED_WITHOUT_MUTEX, 0x39dbd44d, 0x2e44, 0x4931, 0xa4, 0xc8, 0x35, 0x2d, 0x3d, 0xc4, 0x21, 0x15);
95 DEFINE_GUID(ff_MF_SA_MINIMUM_OUTPUT_SAMPLE_COUNT, 0x851745d5, 0xc3d6, 0x476d, 0x95, 0x27, 0x49, 0x8e, 0xf2, 0xd1, 0xd, 0x18);
96 DEFINE_GUID(ff_MF_SA_MINIMUM_OUTPUT_SAMPLE_COUNT_PROGRESSIVE, 0xf5523a5, 0x1cb2, 0x47c5, 0xa5, 0x50, 0x2e, 0xeb, 0x84, 0xb4, 0xd1, 0x4a);
97 
98 DEFINE_MEDIATYPE_GUID(ff_MFVideoFormat_HEVC, 0x43564548); // FCC('HEVC')
99 DEFINE_MEDIATYPE_GUID(ff_MFVideoFormat_HEVC_ES, 0x53564548); // FCC('HEVS')
100 
101 
102 // This enum is missing from mingw-w64's codecapi.h by v7.0.0.
111 };
112 
121 };
122 
123 // These do exist in mingw-w64's mfobjects.idl, but are missing from
124 // mfobjects.h that is generated from the former, due to incorrect use of
125 // ifdefs in the IDL file.
126 enum {
132 };
133 
134 // These do exist in all supported headers, but are manually defined here
135 // to avoid having to include codecapi.h, as there's problems including that
136 // header when targeting UWP (where including it with MSVC seems to work,
137 // but fails when built with clang in MSVC mode).
142 };
143 
144 char *ff_hr_str_buf(char *buf, size_t size, HRESULT hr);
145 #define ff_hr_str(hr) ff_hr_str_buf((char[80]){0}, 80, hr)
146 
147 // Possibly compiler-dependent; the MS/MinGW definition for this is just crazy.
148 #define FF_VARIANT_VALUE(type, contents) &(VARIANT){ .vt = (type), contents }
149 
150 #define FF_VAL_VT_UI4(v) FF_VARIANT_VALUE(VT_UI4, .ulVal = (v))
151 #define FF_VAL_VT_BOOL(v) FF_VARIANT_VALUE(VT_BOOL, .boolVal = (v))
152 
153 IMFSample *ff_create_memory_sample(void *fill_data, size_t size, size_t align);
154 enum AVSampleFormat ff_media_type_to_sample_fmt(IMFAttributes *type);
155 enum AVPixelFormat ff_media_type_to_pix_fmt(IMFAttributes *type);
156 const GUID *ff_pix_fmt_to_guid(enum AVPixelFormat pix_fmt);
157 int ff_fourcc_from_guid(const GUID *guid, uint32_t *out_fourcc);
158 char *ff_guid_str_buf(char *buf, size_t buf_size, const GUID *guid);
159 #define ff_guid_str(guid) ff_guid_str_buf((char[80]){0}, 80, guid)
160 void ff_attributes_dump(void *log, IMFAttributes *attrs);
161 void ff_media_type_dump(void *log, IMFMediaType *type);
162 const CLSID *ff_codec_to_mf_subtype(enum AVCodecID codec);
163 int ff_instantiate_mf(void *log, GUID category,
164  MFT_REGISTER_TYPE_INFO *in_type,
165  MFT_REGISTER_TYPE_INFO *out_type,
166  int use_hw, IMFTransform **res);
167 void ff_free_mf(IMFTransform **mft);
168 
169 #endif
category
Definition: openal-dec.c:248
static enum AVPixelFormat pix_fmt
ff_eAVEncH264VProfile
Definition: mf_utils.h:138
GLint GLenum type
Definition: opengl_enc.c:104
char * ff_hr_str_buf(char *buf, size_t size, HRESULT hr)
Definition: mf_utils.c:83
char * ff_guid_str_buf(char *buf, size_t buf_size, const GUID *guid)
Definition: mf_utils.c:364
void ff_attributes_dump(void *log, IMFAttributes *attrs)
Definition: mf_utils.c:390
ptrdiff_t size
Definition: opengl_enc.c:100
const GUID * guid
Definition: mf_utils.c:242
DEFINE_MEDIATYPE_GUID(ff_MFVideoFormat_HEVC, 0x43564548)
AVCodecID
Identify the syntax and semantics of the bitstream.
Definition: codec_id.h:46
IMFSample * ff_create_memory_sample(void *fill_data, size_t size, size_t align)
Definition: mf_utils.c:109
ff_eAVEncCommonRateControlMode
Definition: mf_utils.h:103
ff_eAVScenarioInfo
Definition: mf_utils.h:113
DEFINE_GUID(ff_CODECAPI_AVDecVideoThumbnailGenerationMode, 0x2efd8eee, 0x1150, 0x4328, 0x9c, 0xf5, 0x66, 0xdc, 0xe9, 0x33, 0xfc, 0xf4)
void ff_media_type_dump(void *log, IMFMediaType *type)
Definition: mf_utils.c:534
int ff_fourcc_from_guid(const GUID *guid, uint32_t *out_fourcc)
Definition: mf_utils.c:222
const GUID * ff_pix_fmt_to_guid(enum AVPixelFormat pix_fmt)
Definition: mf_utils.c:208
HRESULT ff_MFGetAttributeSize(IMFAttributes *pattr, REFGUID guid, UINT32 *pw, UINT32 *ph)
Definition: mf_utils.c:28
Libavcodec external API header.
AVSampleFormat
Audio sample formats.
Definition: samplefmt.h:58
HRESULT ff_MFTEnumEx(GUID guidCategory, UINT32 Flags, const MFT_REGISTER_TYPE_INFO *pInputType, const MFT_REGISTER_TYPE_INFO *pOutputType, IMFActivate ***pppMFTActivate, UINT32 *pnumMFTActivate)
Definition: mf_utils.c:53
const CLSID * ff_codec_to_mf_subtype(enum AVCodecID codec)
Definition: mf_utils.c:539
int ff_instantiate_mf(void *log, GUID category, MFT_REGISTER_TYPE_INFO *in_type, MFT_REGISTER_TYPE_INFO *out_type, int use_hw, IMFTransform **res)
Definition: mf_utils.c:582
enum AVSampleFormat ff_media_type_to_sample_fmt(IMFAttributes *type)
Definition: mf_utils.c:146
void ff_free_mf(IMFTransform **mft)
Definition: mf_utils.c:674
AVPixelFormat
Pixel format.
Definition: pixfmt.h:64
enum AVPixelFormat ff_media_type_to_pix_fmt(IMFAttributes *type)
Definition: mf_utils.c:190
HRESULT ff_MFSetAttributeSize(IMFAttributes *pattr, REFGUID guid, UINT32 uw, UINT32 uh)
Definition: mf_utils.c:40