include/vmr9.idl

   1 /*
   2  * Copyright 2008 Maarten Lankhorst
   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 "unknwn.idl";
  20
  21 cpp_quote("#if 0")
  22 interface IDirect3DSurface9;
  23 interface IDirect3DDevice9;
  24 typedef LONGLONG REFERENCE_TIME;
  25 typedef DWORD D3DFORMAT;
  26 typedef DWORD D3DPOOL;
  27 typedef HANDLE HMONITOR;
  28 typedef struct { char dummy; } AM_MEDIA_TYPE;
  29 typedef struct { char dummy; } D3DCOLOR;
  30 cpp_quote("#endif")
  31
  32 interface IVMRSurface9;
  33 interface IVMRSurfaceAllocator9;
  34 interface IVMRSurfaceAllocatorEx9;
  35 interface IVMRSurfaceAllocatorNotify9;
  36 interface IVMRImagePresenter9;
  37 interface IVMRImagePresenterConfig9;
  38 interface IVMRMonitorConfig9;
  39 interface IVMRWindowlessControl9;
  40 interface IVMRMixerControl9;
  41 interface IVMRImageCompositor9;
  42 interface IVMRMixerBitmap9;
  43 interface IVMRFilterConfig9;
  44 interface IVMRAspectRatioControl9;
  45 interface IVMRVideoStreamControl9;
  46
  47 typedef enum _VMR9PresentationFlags
  48 {
  49     VMR9Sample_SyncPoint = 0x1,
  50     VMR9Sample_Preroll = 0x2,
  51     VMR9Sample_Discontinuity = 0x4,
  52     VMR9Sample_TimeValid = 0x8,
  53     VMR9Sample_SrcDstRectsValid = 0x10
  54 } VMR9PresentationFlags;
  55
  56 typedef struct _VMR9PresentationInfo
  57 {
  58     DWORD dwFlags; /* Flags defined above */
  59     IDirect3DSurface9 *lpSurf;
  60     REFERENCE_TIME rtStart;
  61     REFERENCE_TIME rtEnd;
  62     SIZE szAspectRatio;
  63     RECT rcSrc;
  64     RECT rcDst;
  65     DWORD dwReserved1;
  66     DWORD dwReserved2;
  67 } VMR9PresentationInfo;
  68
  69 [
  70     local,
  71     object,
  72     uuid(69188c61-12a3-40f0-8ffc-342e7b433fd7),
  73     helpstring("IVMRImagePresenter9 interface"),
  74     pointer_default(unique)
  75 ]
  76 interface IVMRImagePresenter9 : IUnknown
  77 {
  78     HRESULT StartPresenting([in] DWORD_PTR id);
  79     HRESULT StopPresenting([in] DWORD_PTR id);
  80     HRESULT PresentImage([in] DWORD_PTR id, [in] VMR9PresentationInfo *info);
  81 }
  82
  83 typedef enum _VMR9SurfaceAllocationFlags
  84 {
  85     VMR9AllocFlag_3DRenderTarget = 0x1,
  86     VMR9AllocFlag_DXVATarget = 0x2,
  87     VMR9AllocFlag_TextureSurface = 0x4,
  88     VMR9AllocFlag_OffscreenSurface = 0x8,
  89     VMR9AllocFlag_RGBDynamicSwitch = 0x10,
  90     VMR9AllocFlag_UsageReserved = 0xe0,
  91     VMR9AllocFlag_UsageMask = 0xff,
  92 } VMR9SurfaceAllocationFlags;
  93
  94 typedef struct _VMR9AllocationInfo
  95 {
  96     DWORD dwFlags; /* Flags defined above */
  97     DWORD dwWidth;
  98     DWORD dwHeight;
  99     D3DFORMAT Format;
 100     D3DPOOL Pool;
 101     DWORD MinBuffers;
 102     SIZE szAspectRatio;
 103     SIZE szNativeSize;
 104 } VMR9AllocationInfo;
 105
 106 [
 107     local,
 108     object,
 109     uuid(8d5148ea-3f5d-46cf-9df1-d1b896eedb1f),
 110     helpstring("IVMRSurfaceAllocator9 interface"),
 111     pointer_default(unique)
 112 ]
 113 interface IVMRSurfaceAllocator9 : IUnknown
 114 {
 115     HRESULT InitializeDevice([in] DWORD_PTR id, [in] VMR9AllocationInfo *allocinfo, [in, out] DWORD *numbuffers);
 116     HRESULT TerminateDevice([in] DWORD_PTR id);
 117     HRESULT GetSurface([in] DWORD_PTR id, [in] DWORD surfaceindex, [in] DWORD flags, [out] IDirect3DSurface9 **surface);
 118     HRESULT AdviseNotify([in] IVMRSurfaceAllocatorNotify9 *allocnotify);
 119 }
 120
 121 [
 122     local,
 123     object,
 124     uuid(6de9a68a-a928-4522-bf57-655ae3866456),
 125     helpstring("IVMRSurfaceAllocatorEx9 interface"),
 126     pointer_default(unique)
 127 ]
 128 interface IVMRSurfaceAllocatorEx9 : IVMRSurfaceAllocator9
 129 {
 130     HRESULT GetSurfaceEx([in] DWORD_PTR id, [in] DWORD surfaceindex, [in] DWORD flags, [out] IDirect3DSurface9 **surface, [out] RECT *dest);
 131 }
 132
 133 [
 134     local,
 135     object,
 136     uuid(dca3f5df-bb3a-4d03-bd81-84614bfbfa0c),
 137     helpstring("IVMRSurfaceAllocatorNotify9 interface"),
 138     pointer_default(unique)
 139 ]
 140 interface IVMRSurfaceAllocatorNotify9 : IUnknown
 141 {
 142     HRESULT AdviseSurfaceAllocator([in] DWORD_PTR id, [in] IVMRSurfaceAllocator9 *alloc);
 143     HRESULT SetD3DDevice([in] IDirect3DDevice9 *device, [in] HMONITOR monitor);
 144     HRESULT ChangeD3DDevice([in] IDirect3DDevice9 *device, [in] HMONITOR monitor);
 145     HRESULT AllocateSurfaceHelper([in] VMR9AllocationInfo *allocinfo, [in, out] DWORD *numbuffers, [out] IDirect3DSurface9 **surface);
 146     HRESULT NotifyEvent([in] LONG code, [in] LONG_PTR param1, [in] LONG_PTR param2);
 147 }
 148
 149 typedef enum _VMR9AspectRatioMode
 150 {
 151     VMR9ARMode_None,
 152     VMR9ARMode_LetterBox
 153 } VMR9AspectRatioMode;
 154
 155 [
 156     local,
 157     object,
 158     uuid(8f537d09-f85e-4414-b23b-502e54c79927),
 159     helpstring("IVMRWindowlessControl interface"),
 160     pointer_default(unique)
 161 ]
 162 interface IVMRWindowlessControl9 : IUnknown
 163 {
 164     HRESULT GetNativeVideoSize([out] LONG *width, [out] LONG *height, [out] LONG *arwidth, [out] LONG *arheight);
 165     HRESULT GetMinIdealVideoSize([out] LONG *width, [out] LONG *height);
 166     HRESULT GetMaxIdealVideoSize([out] LONG *width, [out] LONG *height);
 167     HRESULT SetVideoPosition([in] const RECT *source, [in] const RECT *dest);
 168     HRESULT GetVideoPosition([out] RECT *source, [out] RECT *dest);
 169     HRESULT GetAspectRatioMode([out] DWORD *mode);
 170     HRESULT SetAspectRatioMode([in] DWORD mode);
 171     HRESULT SetVideoClippingWindow([in] HWND hwnd);
 172     HRESULT RepaintVideo([in] HWND hwnd, [in] HDC hdc);
 173     HRESULT DisplayModeChanged();
 174     HRESULT GetCurrentImage([out] BYTE **dib);
 175     HRESULT SetBorderColor([in] COLORREF color);
 176     HRESULT GetBorderColor([out] COLORREF *color);
 177 }
 178
 179 typedef enum _VMR9MixerPrefs
 180 {
 181     /* Decimation */
 182     MixerPref9_NoDecimation = 0x1,
 183     MixerPref9_DecimateOutput = 0x2,
 184     MixerPref9_ARAdjustXorY = 0x4,
 185     MixerPref9_NonSquareMixing = 0x8,
 186     MixerPref9_DecimateMask = 0xf,
 187
 188     /* Filtering */
 189     MixerPref9_BiLinearFiltering = 0x10,
 190     MixerPref9_PointFiltering = 0x20,
 191     MixerPref9_AnisotropicFiltering = 0x40,
 192     MixerPref9_PyramidalQuadFiltering = 0x80,
 193     MixerPref9_GaussianQuadFiltering = 0x100,
 194     MixerPref9_FilteringReserved = 0xe00,
 195     MixerPref9_FilteringMask = 0xff0,
 196
 197     /* Render target */
 198     MixerPref9_RenderTargetRGB = 0x1000,
 199     MixerPref9_RenderTargetYUV = 0x2000,
 200     MixerPref9_RenderTargetReserved = 0xfc000,
 201
 202     MixerPref9_DynamicSwitchToBOB = 0x100000,
 203     MixerPref9_DynamicDecimateBy2 = 0x200000,
 204     MixerPref9_DynamicReserved = 0xc00000,
 205     MixerPref9_DynamicMask = 0xf00000,
 206 } VMR9MixerPrefs;
 207
 208 typedef struct _VMR9NormalizedRect
 209 {
 210     FLOAT left;
 211     FLOAT top;
 212     FLOAT right;
 213     FLOAT bottom;
 214 } VMR9NormalizedRect;
 215
 216 typedef enum _VMR9ProcAmpControlFlags
 217 {
 218     ProcAmpControl9_Brightness = 0x1,
 219     ProcAmpControl9_Contrast = 0x2,
 220     ProcAmpControl9_Hue = 0x4,
 221     ProcAmpControl9_Saturation = 0x8,
 222     ProcAmpControl9_Mask = 0xf
 223 } VMR9ProcAmpControlFlags;
 224
 225 typedef struct _VMR9ProcAmpControl
 226 {
 227     DWORD dwSize;
 228     DWORD dwFlags;
 229     FLOAT Brightness;
 230     FLOAT Contrast;
 231     FLOAT Hue;
 232     FLOAT Saturation;
 233 } VMR9ProcAmpControl;
 234
 235 typedef struct _VMR9ProcAmpControlRange
 236 {
 237     DWORD dwSize;
 238     VMR9ProcAmpControlFlags dwProperty;
 239     FLOAT MinValue;
 240     FLOAT MaxValue;
 241     FLOAT DefaultValue;
 242     FLOAT StepSize;
 243 } VMR9ProcAmpControlRange;
 244
 245 [
 246     local,
 247     object,
 248     uuid(1a777eaa-47c8-4930-b2c9-8fee1c1b0f3b),
 249     helpstring("IVMRMixerControl9 interface"),
 250     pointer_default(unique)
 251 ]
 252 interface IVMRMixerControl9 : IUnknown
 253 {
 254     HRESULT SetAlpha([in] DWORD streamid, [in] FLOAT alpha);
 255     HRESULT GetAlpha([in] DWORD streamid, [out] FLOAT *alpha);
 256     HRESULT SetZOrder([in] DWORD streamid, [in] DWORD zorder);
 257     HRESULT GetZOrder([in] DWORD streamid, [out] DWORD *zorder);
 258     HRESULT SetOutputRect([in] DWORD streamid, [in] const VMR9NormalizedRect *rect);
 259     HRESULT GetOutputRect([in] DWORD streamid, [out] VMR9NormalizedRect *rect);
 260     HRESULT SetBackgroundClr([in] COLORREF back);
 261     HRESULT GetBackgroundClr([out] COLORREF *back);
 262     HRESULT SetMixingPrefs([in] DWORD mixingprefs);
 263     HRESULT GetMixingPrefs([out] DWORD *mixingprefs);
 264     HRESULT SetProcAmpControl([in] DWORD streamid, [in] VMR9ProcAmpControl *control);
 265     HRESULT GetProcAmpControl([in] DWORD streamid, [in, out] VMR9ProcAmpControl *control);
 266     HRESULT GetProcAmpControlRange([in] DWORD streamid, [in, out] VMR9ProcAmpControlRange *controlrange);
 267 }
 268
 269 typedef struct _VMR9AlphaBitmap
 270 {
 271     DWORD dwFlags;
 272     HDC hdc;
 273     IDirect3DSurface9 *pDDS;
 274     RECT rSrc;
 275     VMR9NormalizedRect rDest;
 276     FLOAT fAlpha;
 277     COLORREF clrSrcKey;
 278     DWORD dwFilterMode;
 279 } VMR9AlphaBitmap;
 280
 281 typedef enum _VMR9AlphaBitmapFlags
 282 {
 283     VMR9AlphaBitmap_Disable = 0x1,
 284     VMR9AlphaBitmap_hDC = 0x2,
 285     VMR9AlphaBitmap_EntireDDS = 0x4,
 286     VMR9AlphaBitmap_SrcColorKey = 0x8,
 287     VMR9AlphaBitmap_SrcRect = 0x10,
 288     VMR9AlphaBitmap_FilterMode = 0x20
 289 } VMR9AlphaBitmapFlags;
 290
 291 [
 292     local,
 293     object,
 294     uuid(ced175e5-1935-4820-81bd-ff6ad00c9108),
 295     helpstring("IVMRMixerBitmap interface"),
 296     pointer_default(unique)
 297 ]
 298 interface IVMRMixerBitmap9 : IUnknown
 299 {
 300     HRESULT SetAlphaBitmap([in] const VMR9AlphaBitmap *bitmap);
 301     HRESULT UpdateAlphaBitmapParameters([in] const VMR9AlphaBitmap *bitmap);
 302     HRESULT GetAlphaBitmapParameters([out] VMR9AlphaBitmap *bitmap);
 303 }
 304
 305 [
 306     local,
 307     object,
 308     uuid(dfc581a1-6e1f-4c3a-8d0a-5e9792ea2afc),
 309     helpstring("IVMRSurface interface"),
 310     pointer_default(unique)
 311 ]
 312 interface IVMRSurface9 : IUnknown
 313 {
 314     HRESULT IsSurfaceLocked();
 315     HRESULT LockSurface([out] BYTE **surface);
 316     HRESULT UnlockSurface();
 317     HRESULT GetSurface([out] IDirect3DSurface9 **surface);
 318 }
 319
 320 typedef enum _VMR9RenderPrefs
 321 {
 322    RenderPrefs9_DoNotRenderBorder = 0x1,
 323    RenderPrefs9_Mask = 0x1
 324 } VMR9RenderPrefs;
 325
 326 [
 327     local,
 328     object,
 329     uuid(45c15cab-6e22-420a-8043-ae1f0ac02c7d),
 330     helpstring("IVMRImagePresenterConfig9 interface"),
 331     pointer_default(unique)
 332 ]
 333 interface IVMRImagePresenterConfig9 : IUnknown
 334 {
 335     HRESULT SetRenderingPrefs([in] DWORD renderflags);
 336     HRESULT GetRenderingPrefs([out] DWORD *renderflags);
 337 }
 338
 339 [
 340     local,
 341     object,
 342     uuid(d0cfe38b-93e7-4772-8957-0400c49a4485),
 343     helpstring("IVMRMixerStreamConfig interface"),
 344     pointer_default(unique)
 345 ]
 346 interface IVMRVideoStreamControl9: IUnknown
 347 {
 348     HRESULT SetStreamActiveState([in] BOOL active);
 349     HRESULT GetStreamActiveState([out] BOOL *active);
 350 }
 351
 352 typedef enum _VMR9Mode
 353 {
 354     VMR9Mode_Windowed = 0x1,
 355     VMR9Mode_Windowless = 0x2,
 356     VMR9Mode_Renderless = 0x4,
 357     VMR9Mode_Mask = 0x7
 358 } VMR9Mode;
 359
 360 [
 361     local,
 362     object,
 363     uuid(5a804648-4f66-4867-9c43-4f5c822cf1b8),
 364     helpstring("IVMRFilterConfig9 interface"),
 365     pointer_default(unique)
 366 ]
 367 interface IVMRFilterConfig9 : IUnknown
 368 {
 369     HRESULT SetImageCompositor([in] IVMRImageCompositor9 *compositor);
 370     HRESULT SetNumberOfStreams([in] DWORD max);
 371     HRESULT GetNumberOfStreams([out] DWORD *max);
 372     HRESULT SetRenderingPrefs([in] DWORD renderflags);
 373     HRESULT GetRenderingPrefs([out] DWORD *renderflags);
 374     HRESULT SetRenderingMode([in] DWORD mode);
 375     HRESULT GetRenderingMode([out] DWORD *mode);
 376 }
 377
 378 [
 379     local,
 380     object,
 381     uuid(00d96c29-bbde-4efc-9901-bb5036392146),
 382     helpstring("IVMRAspectRatioControl9 interface"),
 383     pointer_default(unique)
 384 ]
 385 interface IVMRAspectRatioControl9 : IUnknown
 386 {
 387     HRESULT GetAspectRatioMode([out] DWORD *mode);
 388     HRESULT SetAspectRatioMode([in] DWORD mode);
 389 }
 390
 391 #define VMR9DEVICENAMELEN 32
 392 #define VMR9DEVICEDESCRIPTIONLEN 512
 393
 394 typedef struct _VMR9MonitorInfo
 395 {
 396     UINT uDevID;
 397     RECT rcMonitor;
 398     HMONITOR hMon;
 399     DWORD dwFlags;
 400     WCHAR szDevice[VMR9DEVICENAMELEN];
 401     WCHAR szDescription[VMR9DEVICEDESCRIPTIONLEN];
 402     LARGE_INTEGER liDriverVersion;
 403     DWORD dwVendorId;
 404     DWORD dwDeviceId;
 405     DWORD dwSubSysId;
 406     DWORD dwRevision;
 407 } VMR9MonitorInfo;
 408
 409 [
 410     local,
 411     object,
 412     uuid(46c2e457-8ba0-4eef-b80b-0680f0978749),
 413     helpstring("IVMRMonitorConfig9 interface"),
 414     pointer_default(unique)
 415 ]
 416 interface IVMRMonitorConfig9 : IUnknown
 417 {
 418     HRESULT SetMonitor([in] UINT uDev);
 419     HRESULT GetMonitor([out] UINT *uDev);
 420     HRESULT SetDefaultMonitor([in] UINT uDev);
 421     HRESULT GetDefaultMonitor([out] UINT *uDev);
 422     HRESULT GetAvailableMonitors([out, size_is(arraysize)] VMR9MonitorInfo *info, [in] DWORD arraysize, [out] DWORD *numdev);
 423 }
 424
 425 typedef enum _VMR9DeinterlacePrefs
 426 {
 427     DeinterlacePref9_NextBest = 0x1,
 428     DeinterlacePref9_BOB = 0x2,
 429     DeinterlacePref9_Weave = 0x4,
 430     DeinterlacePref9_Mask = 0x7
 431 } VMR9DeinterlacePrefs;
 432
 433 typedef enum _VMR9DeinterlaceTech
 434 {
 435     DeinterlaceTech9_Unknown = 0,
 436     DeinterlaceTech9_BOBLineReplicate = 0x1,
 437     DeinterlaceTech9_BOBVerticalStretch = 0x2,
 438     DeinterlaceTech9_MedianFiltering = 0x4,
 439     DeinterlaceTech9_EdgeFiltering = 0x10,
 440     DeinterlaceTech9_FieldAdaptive = 0x20,
 441     DeinterlaceTech9_PixelAdaptive = 0x40,
 442     DeinterlaceTech9_MotionVectorSteered = 0x80
 443 } VMR9DeinterlaceTech;
 444
 445 typedef struct _VMR9Frequency
 446 {
 447     DWORD dwNumerator;
 448     DWORD dwDenominator;
 449 } VMR9Frequency;
 450
 451 typedef enum _VMR9_SampleFormat
 452 {
 453     VMR9_SampleReserved = 1,
 454     VMR9_SampleProgressiveFrame = 2,
 455     VMR9_SampleFieldInterleavedEvenFirst = 3,
 456     VMR9_SampleFieldInterleavedOddFirst = 4,
 457     VMR9_SampleFieldSingleEven = 5,
 458     VMR9_SampleFieldSingleOdd = 6,
 459 } VMR9_SampleFormat;
 460
 461 typedef struct _VMR9VideoDesc
 462 {
 463     DWORD dwSize;
 464     DWORD dwSampleWidth;
 465     DWORD dwSampleHeight;
 466     VMR9_SampleFormat SampleFormat;
 467     DWORD dwFourCC;
 468     VMR9Frequency InputSampleFreq;
 469     VMR9Frequency OutputFrameFreq;
 470 } VMR9VideoDesc;
 471
 472 typedef struct _VMR9DeinterlaceCaps {
 473     DWORD dwSize;
 474     DWORD dwNumPreviousOutputFrames;
 475     DWORD dwNumForwardRefSamples;
 476     DWORD dwNumBackwardRefSamples;
 477     VMR9DeinterlaceTech DeinterlaceTechnology;
 478 } VMR9DeinterlaceCaps;
 479
 480 [
 481     local,
 482     object,
 483     uuid(a215fb8d-13c2-4f7f-993c-003d6271a459),
 484     helpstring("IVMRDeinterlaceControl9 interface"),
 485     pointer_default(unique)
 486 ]
 487 interface IVMRDeinterlaceControl9 : IUnknown
 488 {
 489     HRESULT GetNumberOfDeinterlaceModes([in] VMR9VideoDesc *desc, [in, out] DWORD *nummodes, [out] GUID *modes);
 490     HRESULT GetDeinterlaceModeCaps([in] GUID *mode, [in] VMR9VideoDesc *desc, [out] VMR9DeinterlaceCaps *caps);
 491     HRESULT GetDeinterlaceMode([in] DWORD streamid, [out] GUID *mode);
 492     HRESULT SetDeinterlaceMode([in] DWORD streamid, [in] GUID *mode);
 493     HRESULT GetDeinterlacePrefs([out] DWORD *prefs);
 494     HRESULT SetDeinterlacePrefs([in] DWORD prefs);
 495     HRESULT GetActualDeinterlaceMode([in] DWORD streamid, [out] GUID *mode);
 496 }
 497
 498 typedef struct _VMR9VideoStreamInfo {
 499     IDirect3DSurface9 *pddsVideoSurface;
 500     DWORD dwWidth;
 501     DWORD dwHeight;
 502     DWORD dwStrmID;
 503     FLOAT fAlpha;
 504     VMR9NormalizedRect rNormal;
 505     REFERENCE_TIME rtStart;
 506     REFERENCE_TIME rtEnd;
 507     VMR9_SampleFormat SampleFormat;
 508 } VMR9VideoStreamInfo;
 509
 510 [
 511     local,
 512     object,
 513     uuid(4a5c89eb-df51-4654-ac2a-e48e02bbabf6),
 514     helpstring("IVMRImageCompositor9 interface"),
 515     pointer_default(unique)
 516 ]
 517 interface IVMRImageCompositor9 : IUnknown
 518 {
 519     HRESULT InitCompositionDevice([in] IUnknown *d3ddev);
 520     HRESULT TermCompositionDevice([in] IUnknown *d3ddev);
 521     HRESULT SetStreamMediaType([in] DWORD stream, [in] AM_MEDIA_TYPE *mt, [in] BOOL texture);
 522     HRESULT CompositeImage([in] IUnknown *d3ddev, [in] IDirect3DSurface9 *d3dtarget, [in] AM_MEDIA_TYPE *mttarget,
 523                            [in] REFERENCE_TIME start, [in] REFERENCE_TIME stop, D3DCOLOR back,
 524                            [in] VMR9VideoStreamInfo *info, [in] UINT streams);
 525 }