include/mfreadwrite.idl

   1 /*
   2  * Copyright (C) 2017 Alistair Leslie-Hughes
   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 "mfobjects.idl";
  20 import "mftransform.idl";
  21
  22 typedef [v1_enum] enum MF_SOURCE_READER_CONTROL_FLAG
  23 {
  24     MF_SOURCE_READER_CONTROLF_DRAIN = 0x00000001,
  25 } MF_SOURCE_READER_CONTROL_FLAG;
  26
  27 enum
  28 {
  29     MF_SOURCE_READER_INVALID_STREAM_INDEX = 0xffffffff,
  30     MF_SOURCE_READER_ALL_STREAMS          = 0xfffffffe,
  31     MF_SOURCE_READER_ANY_STREAM           = 0xfffffffe,
  32     MF_SOURCE_READER_FIRST_AUDIO_STREAM   = 0xfffffffd,
  33     MF_SOURCE_READER_FIRST_VIDEO_STREAM   = 0xfffffffc,
  34     MF_SOURCE_READER_MEDIASOURCE          = 0xffffffff,
  35     MF_SOURCE_READER_CURRENT_TYPE_INDEX   = 0xffffffff
  36 };
  37
  38 typedef [v1_enum] enum MF_SOURCE_READER_FLAG
  39 {
  40     MF_SOURCE_READERF_ERROR                   = 0x00000001,
  41     MF_SOURCE_READERF_ENDOFSTREAM             = 0x00000002,
  42     MF_SOURCE_READERF_NEWSTREAM               = 0x00000004,
  43     MF_SOURCE_READERF_NATIVEMEDIATYPECHANGED  = 0x00000010,
  44     MF_SOURCE_READERF_CURRENTMEDIATYPECHANGED = 0x00000020,
  45     MF_SOURCE_READERF_STREAMTICK              = 0x00000100,
  46     MF_SOURCE_READERF_ALLEFFECTSREMOVED       = 0x00000200,
  47 } MF_SOURCE_READER_FLAG;
  48
  49 enum
  50 {
  51     MF_SINK_WRITER_INVALID_STREAM_INDEX = 0xffffffff,
  52     MF_SINK_WRITER_ALL_STREAMS          = 0xfffffffe,
  53     MF_SINK_WRITER_MEDIASINK            = 0xffffffff,
  54 };
  55
  56 typedef struct _MF_SINK_WRITER_STATISTICS
  57 {
  58     DWORD    cb;
  59     LONGLONG llLastTimestampReceived;
  60     LONGLONG llLastTimestampEncoded;
  61     LONGLONG llLastTimestampProcessed;
  62     LONGLONG llLastStreamTickReceived;
  63     LONGLONG llLastSinkSampleRequest;
  64     QWORD    qwNumSamplesReceived;
  65     QWORD    qwNumSamplesEncoded;
  66     QWORD    qwNumSamplesProcessed;
  67     QWORD    qwNumStreamTicksReceived;
  68     DWORD    dwByteCountQueued;
  69     QWORD    qwByteCountProcessed;
  70     DWORD    dwNumOutstandingSinkSampleRequests;
  71     DWORD    dwAverageSampleRateReceived;
  72     DWORD    dwAverageSampleRateEncoded;
  73     DWORD    dwAverageSampleRateProcessed;
  74 } MF_SINK_WRITER_STATISTICS;
  75
  76 cpp_quote("EXTERN_GUID(CLSID_MFReadWriteClassFactory,           0x48e2ed0f, 0x98c2, 0x4a37, 0xbe, 0xd5, 0x16, 0x63, 0x12, 0xdd, 0xd8, 0x3f);")
  77 cpp_quote("EXTERN_GUID(CLSID_MFSourceReader,                    0x1777133c, 0x0881, 0x411b, 0xa5, 0x77, 0xad, 0x54, 0x5f, 0x07, 0x14, 0xc4);")
  78 cpp_quote("EXTERN_GUID(CLSID_MFSinkWriter,                      0xa3bbfb17, 0x8273, 0x4e52, 0x9e, 0x0e, 0x97, 0x39, 0xdc, 0x88, 0x79, 0x90);")
  79
  80 cpp_quote("EXTERN_GUID(MF_SINK_WRITER_ASYNC_CALLBACK,           0x48cb183e, 0x7b0b, 0x46f4, 0x82, 0x2e, 0x5e, 0x1d, 0x2d, 0xda, 0x43, 0x54);")
  81 cpp_quote("EXTERN_GUID(MF_SINK_WRITER_DISABLE_THROTTLING,       0x08b845d8, 0x2b74, 0x4afe, 0x9d, 0x53, 0xbe, 0x16, 0xd2, 0xd5, 0xae, 0x4f);")
  82 cpp_quote("EXTERN_GUID(MF_SINK_WRITER_D3D_MANAGER,              0xec822da2, 0xe1e9, 0x4b29, 0xa0, 0xd8, 0x56, 0x3c, 0x71, 0x9f, 0x52, 0x69);")
  83 cpp_quote("EXTERN_GUID(MF_SINK_WRITER_ENCODER_CONFIG,           0xad91cd04, 0xa7cc, 0x4ac7, 0x99, 0xb6, 0xa5, 0x7b, 0x9a, 0x4a, 0x7c, 0x70);")
  84
  85 cpp_quote("EXTERN_GUID(MF_READWRITE_DISABLE_CONVERTERS,         0x98d5b065, 0x1374, 0x4847, 0x8d, 0x5d, 0x31, 0x52, 0x0f, 0xee, 0x71, 0x56);")
  86 cpp_quote("EXTERN_GUID(MF_READWRITE_ENABLE_HARDWARE_TRANSFORMS, 0xa634a91c, 0x822b, 0x41b9, 0xa4, 0x94, 0x4d, 0xe4, 0x64, 0x36, 0x12, 0xb0);")
  87 cpp_quote("EXTERN_GUID(MF_READWRITE_MMCSS_CLASS,                0x39384300, 0xd0eb, 0x40b1, 0x87, 0xa0, 0x33, 0x18, 0x87, 0x1b, 0x5a, 0x53);")
  88 cpp_quote("EXTERN_GUID(MF_READWRITE_MMCSS_PRIORITY,             0x43ad19ce, 0xf33f, 0x4ba9, 0xa5, 0x80, 0xe4, 0xcd, 0x12, 0xf2, 0xd1, 0x44);")
  89 cpp_quote("EXTERN_GUID(MF_READWRITE_MMCSS_CLASS_AUDIO,          0x430847da, 0x0890, 0x4b0e, 0x93, 0x8c, 0x05, 0x43, 0x32, 0xc5, 0x47, 0xe1);")
  90 cpp_quote("EXTERN_GUID(MF_READWRITE_MMCSS_PRIORITY_AUDIO,       0x273db885, 0x2de2, 0x4db2, 0xa6, 0xa7, 0xfd, 0xb6, 0x6f, 0xb4, 0x0b, 0x61);")
  91 cpp_quote("EXTERN_GUID(MF_READWRITE_D3D_OPTIONAL,               0x216479d9, 0x3071, 0x42ca, 0xbb, 0x6c, 0x4c, 0x22, 0x10, 0x2e, 0x1d, 0x18);")
  92
  93 cpp_quote("EXTERN_GUID(MF_SOURCE_READER_ASYNC_CALLBACK,                     0x1e3dbeac, 0xbb43, 0x4c35, 0xb5, 0x07, 0xcd, 0x64, 0x44, 0x64, 0xc9, 0x65);")
  94 cpp_quote("EXTERN_GUID(MF_SOURCE_READER_D3D_MANAGER,                        0xec822da2, 0xe1e9, 0x4b29, 0xa0, 0xd8, 0x56, 0x3c, 0x71, 0x9f, 0x52, 0x69);")
  95 cpp_quote("EXTERN_GUID(MF_SOURCE_READER_D3D11_BIND_FLAGS,                   0x33f3197b, 0xf73a, 0x4e14, 0x8d, 0x85, 0x0e, 0x4c, 0x43, 0x68, 0x78, 0x8d);")
  96 cpp_quote("EXTERN_GUID(MF_SOURCE_READER_DISABLE_CAMERA_PLUGINS,             0x9d3365dd, 0x058f, 0x4cfb, 0x9f, 0x97, 0xb3, 0x14, 0xcc, 0x99, 0xc8, 0xad);")
  97 cpp_quote("EXTERN_GUID(MF_SOURCE_READER_DISABLE_DXVA,                       0xaa456cfd, 0x3943, 0x4a1e, 0xa7, 0x7d, 0x18, 0x38, 0xc0, 0xea, 0x2e, 0x35);")
  98 cpp_quote("EXTERN_GUID(MF_SOURCE_READER_DISCONNECT_MEDIASOURCE_ON_SHUTDOWN, 0x56b67165, 0x219e, 0x456d, 0xa2, 0x2e, 0x2d, 0x30, 0x04, 0xc7, 0xfe, 0x56);")
  99 cpp_quote("EXTERN_GUID(MF_SOURCE_READER_ENABLE_ADVANCED_VIDEO_PROCESSING,   0x0f81da2c, 0xb537, 0x4672, 0xa8, 0xb2, 0xa6, 0x81, 0xb1, 0x73, 0x07, 0xa3);")
 100 cpp_quote("EXTERN_GUID(MF_SOURCE_READER_ENABLE_TRANSCODE_ONLY_TRANSFORMS,   0xdfd4f008, 0xb5fd, 0x4e78, 0xae, 0x44, 0x62, 0xa1, 0xe6, 0x7b, 0xbe, 0x27);")
 101 cpp_quote("EXTERN_GUID(MF_SOURCE_READER_ENABLE_VIDEO_PROCESSING,            0xfb394f3d, 0xccf1, 0x42ee, 0xbb, 0xb3, 0xf9, 0xb8, 0x45, 0xd5, 0x68, 0x1d);")
 102 cpp_quote("EXTERN_GUID(MF_SOURCE_READER_MEDIASOURCE_CHARACTERISTICS,        0x6d23f5c8, 0xc5d7, 0x4a9b, 0x99, 0x71, 0x5d, 0x11, 0xf8, 0xbc, 0xa8, 0x80);")
 103 cpp_quote("EXTERN_GUID(MF_SOURCE_READER_MEDIASOURCE_CONFIG,                 0x9085abeb, 0x0354, 0x48f9, 0xab, 0xb5, 0x20, 0x0d, 0xf8, 0x38, 0xc6, 0x8e);")
 104
 105 [
 106     object,
 107     uuid(deec8d99-fa1d-4d82-84c2-2c8969944867),
 108     local
 109 ]
 110 interface IMFSourceReaderCallback : IUnknown
 111 {
 112     HRESULT OnReadSample(
 113             [in] HRESULT hr,
 114             [in] DWORD stream_index,
 115             [in] DWORD stream_flags,
 116             [in] LONGLONG timestamp,
 117             [in] IMFSample *sample);
 118
 119     HRESULT OnFlush([in] DWORD stream_index);
 120
 121     HRESULT OnEvent(
 122             [in] DWORD stream_index,
 123             [in] IMFMediaEvent *event);
 124 }
 125
 126 [
 127     object,
 128     uuid(cf839fe6-8c2a-4dd2-b6ea-c22d6961af05),
 129     local
 130 ]
 131 interface IMFSourceReaderCallback2 : IMFSourceReaderCallback
 132 {
 133     HRESULT OnTransformChange();
 134
 135     HRESULT OnStreamError(
 136             [in] DWORD stream_index,
 137             [in] HRESULT status);
 138 }
 139
 140 interface IMFMediaSource;
 141
 142 [
 143     object,
 144     uuid(70ae66f2-c809-4e4f-8915-bdcb406b7993),
 145     local
 146 ]
 147 interface IMFSourceReader : IUnknown
 148 {
 149     HRESULT GetStreamSelection([in] DWORD index, [out] BOOL *selected);
 150     HRESULT SetStreamSelection([in] DWORD index, [in] BOOL selected);
 151     HRESULT GetNativeMediaType([in] DWORD index, [in] DWORD typeindex, [out] IMFMediaType **type);
 152     HRESULT GetCurrentMediaType([in] DWORD index, [out] IMFMediaType **type);
 153     HRESULT SetCurrentMediaType([in] DWORD index, [in, out] DWORD *reserved, [in] IMFMediaType *type);
 154     HRESULT SetCurrentPosition([in] REFGUID format, [in] REFPROPVARIANT position);
 155     HRESULT ReadSample([in] DWORD index, [in] DWORD flags, [out] DWORD *actualindex, [out] DWORD *sampleflags,
 156                        [out] LONGLONG *timestamp, [out] IMFSample **sample);
 157     HRESULT Flush([in] DWORD index);
 158     HRESULT GetServiceForStream([in] DWORD index, [in] REFGUID service, [in] REFIID riid, [out] void **object);
 159     HRESULT GetPresentationAttribute([in] DWORD index, [in] REFGUID guid, [out] PROPVARIANT *attr);
 160 }
 161
 162 [
 163     object,
 164     uuid(7b981cf0-560e-4116-9875-b099895f23d7),
 165     local
 166 ]
 167 interface IMFSourceReaderEx : IMFSourceReader
 168 {
 169     HRESULT SetNativeMediaType(
 170             [in] DWORD stream_index,
 171             [in] IMFMediaType *media_type,
 172             [out] DWORD *stream_flags);
 173
 174     HRESULT AddTransformForStream(
 175             [in] DWORD stream_index,
 176             [in] IUnknown *transform);
 177
 178     HRESULT RemoveAllTransformsForStream(
 179             [in] DWORD stream_index);
 180
 181     HRESULT GetTransformForStream(
 182             [in] DWORD stream_index,
 183             [in] DWORD transform_index,
 184             [out] GUID *category,
 185             [out] IMFTransform **transform);
 186 }
 187
 188 [
 189     object,
 190     uuid(3137f1cd-fe5e-4805-a5d8-fb477448cb3d),
 191     local
 192 ]
 193 interface IMFSinkWriter : IUnknown
 194 {
 195     HRESULT AddStream([in] IMFMediaType *type, [out] DWORD *index);
 196     HRESULT SetInputMediaType([in] DWORD index, [in] IMFMediaType *type, [in] IMFAttributes *parameters);
 197     HRESULT BeginWriting(void);
 198     HRESULT WriteSample([in] DWORD index, [in] IMFSample *sample);
 199     HRESULT SendStreamTick([in] DWORD index, [in] LONGLONG timestamp);
 200     HRESULT PlaceMarker([in] DWORD index, [in] void *context);
 201     HRESULT NotifyEndOfSegment([in] DWORD index);
 202     HRESULT Flush([in] DWORD index);
 203     HRESULT Finalize(void);
 204     HRESULT GetServiceForStream([in] DWORD index, [in] REFGUID service, [in] REFIID riid, [out] void **object);
 205     HRESULT GetStatistics([in] DWORD index, [out] MF_SINK_WRITER_STATISTICS *stats);
 206 }
 207
 208 [
 209     object,
 210     uuid(588d72ab-5Bc1-496a-8714-b70617141b25),
 211     local
 212 ]
 213 interface IMFSinkWriterEx : IMFSinkWriter
 214 {
 215     HRESULT GetTransformForStream([in] DWORD index, [in] DWORD tindex, [out] GUID *category,
 216                                   [out] IMFTransform **transform);
 217 }
 218
 219 [
 220     object,
 221     uuid(17c3779e-3cde-4ede-8c60-3899f5f53ad6),
 222     local
 223 ]
 224 interface IMFSinkWriterEncoderConfig : IUnknown
 225 {
 226     HRESULT SetTargetMediaType(
 227             [in] DWORD stream_index,
 228             [in] IMFMediaType *media_type,
 229             [in] IMFAttributes *encoding_parameters);
 230
 231     HRESULT PlaceEncodingParameters(
 232             [in] DWORD stream_index,
 233             [in] IMFAttributes *encoding_parameters);
 234 }
 235
 236 [
 237     object,
 238     uuid(666f76de-33d2-41b9-a458-29ed0a972c58),
 239     local
 240 ]
 241 interface IMFSinkWriterCallback : IUnknown
 242 {
 243     HRESULT OnFinalize(
 244             [in] HRESULT status);
 245
 246     HRESULT OnMarker(
 247             [in] DWORD stream_index,
 248             [in] void *context);
 249 }
 250
 251 [
 252     object,
 253     uuid(2456bd58-c067-4513-84fe-8d0c88ffdc61),
 254     local
 255 ]
 256 interface IMFSinkWriterCallback2 : IMFSinkWriterCallback
 257 {
 258     HRESULT OnTransformChange();
 259
 260     HRESULT OnStreamError(
 261             [in] DWORD stream_index,
 262             [in] HRESULT status);
 263 }
 264
 265 [
 266     object,
 267     uuid(e7fe2e12-661c-40da-92f9-4f002ab67627),
 268     local
 269 ]
 270 interface IMFReadWriteClassFactory : IUnknown
 271 {
 272     HRESULT CreateInstanceFromURL([in] REFCLSID clsid, [in] LPCWSTR url, [in] IMFAttributes *attributes,
 273                                   [in] REFIID riid, [out, iid_is(riid)] void **object );
 274
 275     HRESULT CreateInstanceFromObject([in] REFCLSID clsid, [in] IUnknown *unk, [in] IMFAttributes *attributes,
 276                                      [in] REFIID riid, [out, iid_is(riid)] void **object );
 277 }
 278
 279 cpp_quote( "HRESULT WINAPI MFCreateSinkWriterFromMediaSink(IMFMediaSink *sink, IMFAttributes *attributes," )
 280 cpp_quote( "        IMFSinkWriter **writer);" )
 281 cpp_quote( "HRESULT WINAPI MFCreateSinkWriterFromURL(const WCHAR *url, IMFByteStream *bytestream," )
 282 cpp_quote( "        IMFAttributes *attributes, IMFSinkWriter **writer);" )
 283 cpp_quote( "HRESULT WINAPI MFCreateSourceReaderFromByteStream(IMFByteStream *stream, IMFAttributes *attributes," )
 284 cpp_quote( "                                                  IMFSourceReader **reader);" )
 285 cpp_quote( "HRESULT WINAPI MFCreateSourceReaderFromMediaSource(IMFMediaSource *source, IMFAttributes *attributes," )
 286 cpp_quote( "                                                   IMFSourceReader **reader);" )
 287 cpp_quote( "HRESULT WINAPI MFCreateSourceReaderFromURL(const WCHAR *url, IMFAttributes *attributes, IMFSourceReader **reader);" )