avformat/mov: disallow a zero sample size in trun atoms
[ffmpeg.git] / libavcodec / mf_utils.h
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 // Windows N editions does not provide MediaFoundation by default.
45 // So to avoid DLL loading error, MediaFoundation will be dynamically loaded
46 // except on UWP build since LoadLibrary is not available on it.
47 typedef struct MFFunctions {
48     HRESULT (WINAPI *MFStartup) (ULONG Version, DWORD dwFlags);
49     HRESULT (WINAPI *MFShutdown) (void);
50     HRESULT (WINAPI *MFCreateAlignedMemoryBuffer) (DWORD cbMaxLength,
51                                                    DWORD cbAligment,
52                                                    IMFMediaBuffer **ppBuffer);
53     HRESULT (WINAPI *MFCreateSample) (IMFSample **ppIMFSample);
54     HRESULT (WINAPI *MFCreateMediaType) (IMFMediaType **ppMFType);
55     // MFTEnumEx is missing in Windows Vista's mfplat.dll.
56     HRESULT (WINAPI *MFTEnumEx)(GUID guidCategory, UINT32 Flags,
57                                 const MFT_REGISTER_TYPE_INFO *pInputType,
58                                 const MFT_REGISTER_TYPE_INFO *pOutputType,
59                                 IMFActivate ***pppMFTActivate,
60                                 UINT32 *pnumMFTActivate);
61 } MFFunctions;
62
63 // These functions do exist in mfapi.h, but are only available within
64 // __cplusplus ifdefs.
65 HRESULT ff_MFGetAttributeSize(IMFAttributes *pattr, REFGUID guid,
66                               UINT32 *pw, UINT32 *ph);
67 HRESULT ff_MFSetAttributeSize(IMFAttributes *pattr, REFGUID guid,
68                               UINT32 uw, UINT32 uh);
69 #define ff_MFSetAttributeRatio ff_MFSetAttributeSize
70 #define ff_MFGetAttributeRatio ff_MFGetAttributeSize
71
72 // These do exist in mingw-w64's codecapi.h, but they aren't properly defined
73 // by the header until after mingw-w64 v7.0.0.
74 DEFINE_GUID(ff_CODECAPI_AVDecVideoThumbnailGenerationMode, 0x2efd8eee,0x1150,0x4328,0x9c,0xf5,0x66,0xdc,0xe9,0x33,0xfc,0xf4);
75 DEFINE_GUID(ff_CODECAPI_AVDecVideoDropPicWithMissingRef, 0xf8226383,0x14c2,0x4567,0x97,0x34,0x50,0x04,0xe9,0x6f,0xf8,0x87);
76 DEFINE_GUID(ff_CODECAPI_AVDecVideoSoftwareDeinterlaceMode, 0x0c08d1ce,0x9ced,0x4540,0xba,0xe3,0xce,0xb3,0x80,0x14,0x11,0x09);
77 DEFINE_GUID(ff_CODECAPI_AVDecVideoFastDecodeMode, 0x6b529f7d,0xd3b1,0x49c6,0xa9,0x99,0x9e,0xc6,0x91,0x1b,0xed,0xbf);
78 DEFINE_GUID(ff_CODECAPI_AVLowLatencyMode, 0x9c27891a,0xed7a,0x40e1,0x88,0xe8,0xb2,0x27,0x27,0xa0,0x24,0xee);
79 DEFINE_GUID(ff_CODECAPI_AVDecVideoH264ErrorConcealment, 0xececace8,0x3436,0x462c,0x92,0x94,0xcd,0x7b,0xac,0xd7,0x58,0xa9);
80 DEFINE_GUID(ff_CODECAPI_AVDecVideoMPEG2ErrorConcealment, 0x9d2bfe18,0x728d,0x48d2,0xb3,0x58,0xbc,0x7e,0x43,0x6c,0x66,0x74);
81 DEFINE_GUID(ff_CODECAPI_AVDecVideoCodecType, 0x434528e5,0x21f0,0x46b6,0xb6,0x2c,0x9b,0x1b,0x6b,0x65,0x8c,0xd1);
82 DEFINE_GUID(ff_CODECAPI_AVDecVideoDXVAMode, 0xf758f09e,0x7337,0x4ae7,0x83,0x87,0x73,0xdc,0x2d,0x54,0xe6,0x7d);
83 DEFINE_GUID(ff_CODECAPI_AVDecVideoDXVABusEncryption, 0x42153c8b,0xfd0b,0x4765,0xa4,0x62,0xdd,0xd9,0xe8,0xbc,0xc3,0x88);
84 DEFINE_GUID(ff_CODECAPI_AVDecVideoSWPowerLevel, 0xfb5d2347,0x4dd8,0x4509,0xae,0xd0,0xdb,0x5f,0xa9,0xaa,0x93,0xf4);
85 DEFINE_GUID(ff_CODECAPI_AVDecVideoMaxCodedWidth, 0x5ae557b8,0x77af,0x41f5,0x9f,0xa6,0x4d,0xb2,0xfe,0x1d,0x4b,0xca);
86 DEFINE_GUID(ff_CODECAPI_AVDecVideoMaxCodedHeight, 0x7262a16a,0xd2dc,0x4e75,0x9b,0xa8,0x65,0xc0,0xc6,0xd3,0x2b,0x13);
87 DEFINE_GUID(ff_CODECAPI_AVDecNumWorkerThreads, 0x9561c3e8,0xea9e,0x4435,0x9b,0x1e,0xa9,0x3e,0x69,0x18,0x94,0xd8);
88 DEFINE_GUID(ff_CODECAPI_AVDecSoftwareDynamicFormatChange, 0x862e2f0a,0x507b,0x47ff,0xaf,0x47,0x01,0xe2,0x62,0x42,0x98,0xb7);
89 DEFINE_GUID(ff_CODECAPI_AVDecDisableVideoPostProcessing, 0xf8749193,0x667a,0x4f2c,0xa9,0xe8,0x5d,0x4a,0xf9,0x24,0xf0,0x8f);
90
91 // These are missing from mingw-w64's headers until after mingw-w64 v7.0.0.
92 DEFINE_GUID(ff_CODECAPI_AVEncCommonRateControlMode,      0x1c0608e9, 0x370c, 0x4710, 0x8a, 0x58, 0xcb, 0x61, 0x81, 0xc4, 0x24, 0x23);
93 DEFINE_GUID(ff_CODECAPI_AVEncCommonQuality,       0xfcbf57a3, 0x7ea5, 0x4b0c, 0x96, 0x44, 0x69, 0xb4, 0x0c, 0x39, 0xc3, 0x91);
94 DEFINE_GUID(ff_CODECAPI_AVEncCommonMeanBitRate,   0xf7222374, 0x2144, 0x4815, 0xb5, 0x50, 0xa3, 0x7f, 0x8e, 0x12, 0xee, 0x52);
95 DEFINE_GUID(ff_CODECAPI_AVEncH264CABACEnable,    0xee6cad62, 0xd305, 0x4248, 0xa5, 0xe, 0xe1, 0xb2, 0x55, 0xf7, 0xca, 0xf8);
96 DEFINE_GUID(ff_CODECAPI_AVEncVideoForceKeyFrame, 0x398c1b98, 0x8353, 0x475a, 0x9e, 0xf2, 0x8f, 0x26, 0x5d, 0x26, 0x3, 0x45);
97 DEFINE_GUID(ff_CODECAPI_AVEncMPVDefaultBPictureCount, 0x8d390aac, 0xdc5c, 0x4200, 0xb5, 0x7f, 0x81, 0x4d, 0x04, 0xba, 0xba, 0xb2);
98 DEFINE_GUID(ff_CODECAPI_AVScenarioInfo, 0xb28a6e64,0x3ff9,0x446a,0x8a,0x4b,0x0d,0x7a,0x53,0x41,0x32,0x36);
99
100 DEFINE_GUID(ff_MF_SA_D3D11_BINDFLAGS, 0xeacf97ad, 0x065c, 0x4408, 0xbe, 0xe3, 0xfd, 0xcb, 0xfd, 0x12, 0x8b, 0xe2);
101 DEFINE_GUID(ff_MF_SA_D3D11_USAGE, 0xe85fe442, 0x2ca3, 0x486e, 0xa9, 0xc7, 0x10, 0x9d, 0xda, 0x60, 0x98, 0x80);
102 DEFINE_GUID(ff_MF_SA_D3D11_AWARE, 0x206b4fc8, 0xfcf9, 0x4c51, 0xaf, 0xe3, 0x97, 0x64, 0x36, 0x9e, 0x33, 0xa0);
103 DEFINE_GUID(ff_MF_SA_D3D11_SHARED, 0x7b8f32c3, 0x6d96, 0x4b89, 0x92, 0x3, 0xdd, 0x38, 0xb6, 0x14, 0x14, 0xf3);
104 DEFINE_GUID(ff_MF_SA_D3D11_SHARED_WITHOUT_MUTEX, 0x39dbd44d, 0x2e44, 0x4931, 0xa4, 0xc8, 0x35, 0x2d, 0x3d, 0xc4, 0x21, 0x15);
105 DEFINE_GUID(ff_MF_SA_MINIMUM_OUTPUT_SAMPLE_COUNT, 0x851745d5, 0xc3d6, 0x476d, 0x95, 0x27, 0x49, 0x8e, 0xf2, 0xd1, 0xd, 0x18);
106 DEFINE_GUID(ff_MF_SA_MINIMUM_OUTPUT_SAMPLE_COUNT_PROGRESSIVE, 0xf5523a5, 0x1cb2, 0x47c5, 0xa5, 0x50, 0x2e, 0xeb, 0x84, 0xb4, 0xd1, 0x4a);
107
108 DEFINE_MEDIATYPE_GUID(ff_MFVideoFormat_HEVC, 0x43564548); // FCC('HEVC')
109 DEFINE_MEDIATYPE_GUID(ff_MFVideoFormat_HEVC_ES, 0x53564548); // FCC('HEVS')
110
111
112 // This enum is missing from mingw-w64's codecapi.h by v7.0.0.
113 enum ff_eAVEncCommonRateControlMode {
114     ff_eAVEncCommonRateControlMode_CBR                 = 0,
115     ff_eAVEncCommonRateControlMode_PeakConstrainedVBR  = 1,
116     ff_eAVEncCommonRateControlMode_UnconstrainedVBR    = 2,
117     ff_eAVEncCommonRateControlMode_Quality             = 3,
118     ff_eAVEncCommonRateControlMode_LowDelayVBR         = 4,
119     ff_eAVEncCommonRateControlMode_GlobalVBR           = 5,
120     ff_eAVEncCommonRateControlMode_GlobalLowDelayVBR   = 6
121 };
122
123 enum ff_eAVScenarioInfo {
124     ff_eAVScenarioInfo_Unknown                         = 0,
125     ff_eAVScenarioInfo_DisplayRemoting                 = 1,
126     ff_eAVScenarioInfo_VideoConference                 = 2,
127     ff_eAVScenarioInfo_Archive                         = 3,
128     ff_eAVScenarioInfo_LiveStreaming                   = 4,
129     ff_eAVScenarioInfo_CameraRecord                    = 5,
130     ff_eAVScenarioInfo_DisplayRemotingWithFeatureMap   = 6
131 };
132
133 // These do exist in mingw-w64's mfobjects.idl, but are missing from
134 // mfobjects.h that is generated from the former, due to incorrect use of
135 // ifdefs in the IDL file.
136 enum {
137     ff_METransformUnknown = 600,
138     ff_METransformNeedInput,
139     ff_METransformHaveOutput,
140     ff_METransformDrainComplete,
141     ff_METransformMarker,
142 };
143
144 // These do exist in all supported headers, but are manually defined here
145 // to avoid having to include codecapi.h, as there's problems including that
146 // header when targeting UWP (where including it with MSVC seems to work,
147 // but fails when built with clang in MSVC mode).
148 enum ff_eAVEncH264VProfile {
149    ff_eAVEncH264VProfile_Base = 66,
150    ff_eAVEncH264VProfile_Main = 77,
151    ff_eAVEncH264VProfile_High = 100,
152 };
153
154 char *ff_hr_str_buf(char *buf, size_t size, HRESULT hr);
155 #define ff_hr_str(hr) ff_hr_str_buf((char[80]){0}, 80, hr)
156
157 // Possibly compiler-dependent; the MS/MinGW definition for this is just crazy.
158 #define FF_VARIANT_VALUE(type, contents) &(VARIANT){ .vt = (type), contents }
159
160 #define FF_VAL_VT_UI4(v) FF_VARIANT_VALUE(VT_UI4, .ulVal = (v))
161 #define FF_VAL_VT_BOOL(v) FF_VARIANT_VALUE(VT_BOOL, .boolVal = (v))
162
163 IMFSample *ff_create_memory_sample(MFFunctions *f, void *fill_data,
164                                    size_t size, size_t align);
165 enum AVSampleFormat ff_media_type_to_sample_fmt(IMFAttributes *type);
166 enum AVPixelFormat ff_media_type_to_pix_fmt(IMFAttributes *type);
167 const GUID *ff_pix_fmt_to_guid(enum AVPixelFormat pix_fmt);
168 int ff_fourcc_from_guid(const GUID *guid, uint32_t *out_fourcc);
169 char *ff_guid_str_buf(char *buf, size_t buf_size, const GUID *guid);
170 #define ff_guid_str(guid) ff_guid_str_buf((char[80]){0}, 80, guid)
171 void ff_attributes_dump(void *log, IMFAttributes *attrs);
172 void ff_media_type_dump(void *log, IMFMediaType *type);
173 const CLSID *ff_codec_to_mf_subtype(enum AVCodecID codec);
174 int ff_instantiate_mf(void *log, MFFunctions *f, GUID category,
175                       MFT_REGISTER_TYPE_INFO *in_type,
176                       MFT_REGISTER_TYPE_INFO *out_type,
177                       int use_hw, IMFTransform **res);
178 void ff_free_mf(MFFunctions *f, IMFTransform **mft);
179
180 #endif