include/mfmediaengine.idl

   1 /*
   2  * Copyright 2019 Jactry Zeng for CodeWeavers
   3  *
   4  * This library 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  * This library 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 this library; if not, write to the Free Software
  16  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  17  */
  18
  19 import "mfidl.idl";
  20
  21 cpp_quote("EXTERN_GUID(CLSID_MFMediaEngineClassFactory, 0xb44392da, 0x499b, 0x446b, 0xa4, 0xcb, 0x00, 0x5f, 0xea, 0xd0, 0xe6, 0xd5);")
  22
  23 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_AUDIO_CATEGORY,                     0xc8d4c51d, 0x350e, 0x41f2, 0xba, 0x46, 0xfa, 0xeb, 0xbb, 0x08, 0x57, 0xf6);")
  24 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_AUDIO_ENDPOINT_ROLE,                0xd2cb93d1, 0x116a, 0x44f2, 0x93, 0x85, 0xf7, 0xd0, 0xfd, 0xa2, 0xfb, 0x46);")
  25 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_BROWSER_COMPATIBILITY_MODE,         0x4e0212e2, 0xe18f, 0x41e1, 0x95, 0xe5, 0xc0, 0xe7, 0xe9, 0x23, 0x5b, 0xc3);")
  26 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_BROWSER_COMPATIBILITY_MODE_IE9,     0x052c2d39, 0x40c0, 0x4188, 0xab, 0x86, 0xf8, 0x28, 0x27, 0x3b, 0x75, 0x22);")
  27 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_BROWSER_COMPATIBILITY_MODE_IE10,    0x11a47afd, 0x6589, 0x4124, 0xb3, 0x12, 0x61, 0x58, 0xec, 0x51, 0x7f, 0xc3);")
  28 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_BROWSER_COMPATIBILITY_MODE_IE11,    0x1cf1315f, 0xce3f, 0x4035, 0x93, 0x91, 0x16, 0x14, 0x2f, 0x77, 0x51, 0x89);")
  29 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_BROWSER_COMPATIBILITY_MODE_IE_EDGE, 0xa6f3e465, 0x3aca, 0x442c, 0xa3, 0xf0, 0xad, 0x6d, 0xda, 0xd8, 0x39, 0xae);")
  30 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_CALLBACK,                           0xc60381b8, 0x83a4, 0x41f8, 0xa3, 0xd0, 0xde, 0x05, 0x07, 0x68, 0x49, 0xa9);")
  31 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_COMPATIBILITY_MODE,                 0x3ef26ad4, 0xdc54, 0x45de, 0xb9, 0xaf, 0x76, 0xc8, 0xc6, 0x6b, 0xfa, 0x8e);")
  32 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_COMPATIBILITY_MODE_WIN10,           0x5b25e089, 0x6ca7, 0x4139, 0xa2, 0xcb, 0xfc, 0xaa, 0xb3, 0x95, 0x52, 0xa3);")
  33 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_COMPATIBILITY_MODE_WWA_EDGE,        0x15b29098, 0x9f01, 0x4e4d, 0xb6, 0x5a, 0xc0, 0x6c, 0x6c, 0x89, 0xda, 0x2a);")
  34 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_CONTENT_PROTECTION_FLAGS,           0xe0350223, 0x5aaf, 0x4d76, 0xa7, 0xc3, 0x06, 0xde, 0x70, 0x89, 0x4d, 0xb4);")
  35 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_CONTENT_PROTECTION_MANAGER,         0xfdd6dfaa, 0xbd85, 0x4af3, 0x9e, 0x0f, 0xa0, 0x1d, 0x53, 0x9d, 0x87, 0x6a);")
  36 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_CONTINUE_ON_CODEC_ERROR,            0xdbcdb7f9, 0x48e4, 0x4295, 0xb7, 0x0d, 0xd5, 0x18, 0x23, 0x4e, 0xeb, 0x38);")
  37 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_COREWINDOW,                         0xfccae4dc, 0x0b7f, 0x41c2, 0x9f, 0x96, 0x46, 0x59, 0x94, 0x8a, 0xcd, 0xdc);")
  38 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_DXGI_MANAGER,                       0x065702da, 0x1094, 0x486d, 0x86, 0x17, 0xee, 0x7c, 0xc4, 0xee, 0x46, 0x48);")
  39 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_EME_CALLBACK,                       0x494553a7, 0xa481, 0x4cb7, 0xbe, 0xc5, 0x38, 0x09, 0x03, 0x51, 0x37, 0x31);")
  40 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_EXTENSION,                          0x3109fd46, 0x060d, 0x4b62, 0x8d, 0xcf, 0xfa, 0xff, 0x81, 0x13, 0x18, 0xd2);")
  41 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_MEDIA_PLAYER_MODE,                  0x3ddd8d45, 0x5aa1, 0x4112, 0x82, 0xe5, 0x36, 0xf6, 0xa2, 0x19, 0x7e, 0x6e);")
  42 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_NEEDKEY_CALLBACK,                   0x7ea80843, 0xb6e4, 0x432c, 0x8e, 0xa4, 0x78, 0x48, 0xff, 0xe4, 0x22, 0x0e);")
  43 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_OPM_HWND,                           0xa0be8ee7, 0x0572, 0x4f2c, 0xa8, 0x01, 0x2a, 0x15, 0x1b, 0xd3, 0xe7, 0x26);")
  44 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_PLAYBACK_HWND,                      0xd988879b, 0x67c9, 0x4d92, 0xba, 0xa7, 0x6e, 0xad, 0xd4, 0x46, 0x03, 0x9d);")
  45 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_PLAYBACK_VISUAL,                    0x6debd26f, 0x6ab9, 0x4d7e, 0xb0, 0xee, 0xc6, 0x1a, 0x73, 0xff, 0xad, 0x15);")
  46 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_SOURCE_RESOLVER_CONFIG_STORE,       0x0ac0c497, 0xb3c4, 0x48c9, 0x9c, 0xde, 0xbb, 0x8c, 0xa2, 0x44, 0x2c, 0xa3);")
  47 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_STREAM_CONTAINS_ALPHA_CHANNEL,      0x5cbfaf44, 0xd2b2, 0x4cfb, 0x80, 0xa7, 0xd4, 0x29, 0xc7, 0x4c, 0x78, 0x9d);")
  48 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_SYNCHRONOUS_CLOSE,                  0xc3c2e12f, 0x7e0e, 0x4e43, 0xb9, 0x1c, 0xdc, 0x99, 0x2c, 0xcd, 0xfa, 0x5e);")
  49 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_TELEMETRY_APPLICATION_ID,           0x1e7b273b, 0xa7e4, 0x402a, 0x8f, 0x51, 0xc4, 0x8e, 0x88, 0xa2, 0xca, 0xbc);")
  50 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_TRACK_ID,                           0x65bea312, 0x4043, 0x4815, 0x8e, 0xab, 0x44, 0xdc, 0xe2, 0xef, 0x8f, 0x2a);")
  51 cpp_quote("EXTERN_GUID(MF_MEDIA_ENGINE_VIDEO_OUTPUT_FORMAT,                0x5066893c, 0x8cf9, 0x42bc, 0x8b, 0x8a, 0x47, 0x22, 0x12, 0xe5, 0x27, 0x26);")
  52
  53 typedef enum MF_MEDIA_ENGINE_ERR
  54 {
  55     MF_MEDIA_ENGINE_ERR_NOERROR,
  56     MF_MEDIA_ENGINE_ERR_ABORTED,
  57     MF_MEDIA_ENGINE_ERR_NETWORK,
  58     MF_MEDIA_ENGINE_ERR_DECODE,
  59     MF_MEDIA_ENGINE_ERR_SRC_NOT_SUPPORTED,
  60     MF_MEDIA_ENGINE_ERR_ENCRYPTED
  61 } MF_MEDIA_ENGINE_ERR;
  62
  63 typedef enum MF_MEDIA_ENGINE_PRELOAD
  64 {
  65     MF_MEDIA_ENGINE_PRELOAD_MISSING,
  66     MF_MEDIA_ENGINE_PRELOAD_EMPTY,
  67     MF_MEDIA_ENGINE_PRELOAD_NONE,
  68     MF_MEDIA_ENGINE_PRELOAD_METADATA,
  69     MF_MEDIA_ENGINE_PRELOAD_AUTOMATIC
  70 } MF_MEDIA_ENGINE_PRELOAD;
  71
  72 typedef enum MF_MEDIA_ENGINE_CANPLAY
  73 {
  74     MF_MEDIA_ENGINE_CANPLAY_NOT_SUPPORTED,
  75     MF_MEDIA_ENGINE_CANPLAY_MAYBE,
  76     MF_MEDIA_ENGINE_CANPLAY_PROBABLY,
  77 } MF_MEDIA_ENGINE_CANPLAY;
  78
  79 typedef struct MFVideoNormalizedRect
  80 {
  81     float left;
  82     float top;
  83     float right;
  84     float bottom;
  85 } MFVideoNormalizedRect;
  86
  87 typedef enum MF_MEDIA_ENGINE_CREATEFLAGS
  88 {
  89     MF_MEDIA_ENGINE_AUDIOONLY = 0x1,
  90     MF_MEDIA_ENGINE_WAITFORSTABLE_STATE = 0x2,
  91     MF_MEDIA_ENGINE_FORCEMUTE = 0x4,
  92     MF_MEDIA_ENGINE_REAL_TIME_MODE = 0x8,
  93     MF_MEDIA_ENGINE_DISABLE_LOCAL_PLUGINS = 0x10,
  94     MF_MEDIA_ENGINE_CREATEFLAGS_MASK = 0x1f
  95 } MF_MEDIA_ENGINE_CREATEFLAGS;
  96
  97 [
  98     object,
  99     uuid(fc0e10d2-ab2a-4501-a951-06bb1075184c),
 100     local,
 101     pointer_default(unique)
 102 ]
 103 interface IMFMediaError : IUnknown
 104 {
 105     USHORT GetErrorCode();
 106     HRESULT GetExtendedErrorCode();
 107     HRESULT SetErrorCode([in] MF_MEDIA_ENGINE_ERR error);
 108     HRESULT SetExtendedErrorCode([in] HRESULT error);
 109 }
 110
 111 [
 112     object,
 113     uuid(7a5e5354-b114-4c72-b991-3131d75032ea),
 114     local,
 115     pointer_default(unique)
 116 ]
 117 interface IMFMediaEngineSrcElements : IUnknown
 118 {
 119     DWORD GetLength();
 120     HRESULT GetURL([in] DWORD index, [out] BSTR *url);
 121     HRESULT GetType([in] DWORD index, [out] BSTR *type);
 122     HRESULT GetMedia([in] DWORD index, [out] BSTR *media);
 123     HRESULT AddElement([in] BSTR url, [in] BSTR type, [in] BSTR media);
 124     HRESULT RemoveAllElements();
 125 }
 126
 127 [
 128     object,
 129     uuid(db71a2fc-078a-414e-9df9-8c2531b0aa6c),
 130     local,
 131     pointer_default(unique)
 132 ]
 133 interface IMFMediaTimeRange : IUnknown
 134 {
 135     DWORD GetLength();
 136     HRESULT GetStart([in] DWORD index, [out] double *start);
 137     HRESULT GetEnd([in] DWORD index, [out] double *end);
 138     BOOL ContainsTime([in] double time);
 139     HRESULT AddRange([in] double start, [in] double end);
 140     HRESULT Clear();
 141 }
 142
 143 [
 144     object,
 145     uuid(98a1b0bb-03eb-4935-ae7c-93c1fa0e1c93),
 146     local,
 147     pointer_default(unique)
 148 ]
 149 interface IMFMediaEngine : IUnknown
 150 {
 151     HRESULT GetError([out] IMFMediaError **error);
 152     HRESULT SetErrorCode([in] MF_MEDIA_ENGINE_ERR error);
 153     HRESULT SetSourceElements([in] IMFMediaEngineSrcElements *elements);
 154     HRESULT SetSource([in] BSTR url);
 155     HRESULT GetCurrentSource([out] BSTR *url);
 156     USHORT GetNetworkState();
 157     MF_MEDIA_ENGINE_PRELOAD GetPreload();
 158     HRESULT SetPreload([in] MF_MEDIA_ENGINE_PRELOAD preload);
 159     HRESULT GetBuffered([out] IMFMediaTimeRange **buffered);
 160     HRESULT Load();
 161     HRESULT CanPlayType([in] BSTR type, [out] MF_MEDIA_ENGINE_CANPLAY *answer);
 162     USHORT GetReadyState();
 163     BOOL IsSeeking();
 164     cpp_quote("#undef GetCurrentTime")
 165     double GetCurrentTime();
 166     HRESULT SetCurrentTime([in] double time);
 167     double GetStartTime();
 168     double GetDuration();
 169     BOOL IsPaused();
 170     double GetDefaultPlaybackRate();
 171     HRESULT SetDefaultPlaybackRate([in] double rate);
 172     double GetPlaybackRate();
 173     HRESULT SetPlaybackRate([in] double rate);
 174     HRESULT GetPlayed([out] IMFMediaTimeRange **played);
 175     HRESULT GetSeekable([out] IMFMediaTimeRange **seekable);
 176     BOOL IsEnded();
 177     BOOL GetAutoPlay();
 178     HRESULT SetAutoPlay([in] BOOL autoplay);
 179     BOOL GetLoop();
 180     HRESULT SetLoop([in] BOOL loop);
 181     HRESULT Play();
 182     HRESULT Pause();
 183     BOOL GetMuted();
 184     HRESULT SetMuted([in] BOOL muted);
 185     double GetVolume();
 186     HRESULT SetVolume([in] double volume);
 187     BOOL HasVideo();
 188     BOOL HasAudio();
 189     HRESULT GetNativeVideoSize([out] DWORD *cx, [out] DWORD *cy);
 190     HRESULT GetVideoAspectRatio([out] DWORD *cx, [out] DWORD *cy);
 191     HRESULT Shutdown();
 192     HRESULT TransferVideoFrame([in] IUnknown *surface, [in] const MFVideoNormalizedRect *src,
 193                                [in] const RECT *dst, [in] const MFARGB *color);
 194     HRESULT OnVideoStreamTick([out] LONGLONG *time);
 195 }
 196
 197 [
 198     object,
 199     uuid(4d645ace-26aa-4688-9be1-df3516990b93),
 200     local,
 201     pointer_default(unique)
 202 ]
 203 interface IMFMediaEngineClassFactory : IUnknown
 204 {
 205     HRESULT CreateInstance([in] DWORD flags, [in] IMFAttributes *attributes, [out] IMFMediaEngine **engine);
 206     HRESULT CreateTimeRange([out] IMFMediaTimeRange **range);
 207     HRESULT CreateError([out] IMFMediaError **error);
 208 }
 209
 210 [
 211     object,
 212     uuid(fee7c112-e776-42b5-9bbf-0048524e2bd5),
 213     local,
 214     pointer_default(unique)
 215 ]
 216 interface IMFMediaEngineNotify : IUnknown
 217 {
 218     HRESULT EventNotify([in] DWORD event, [in] DWORD_PTR param1, [in] DWORD param2);
 219 }