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