include/axextend.idl

   1 /*
   2  * Copyright (C) 2002 Robert Shearman
   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 interface IAMAnalogVideoDecoder;
  20 interface IAMAnalogVideoEncoder;
  21 interface IAMAudioInputMixer;
  22 interface IAMAudioRendererStats;
  23 interface IAMBufferNegotiation;
  24 interface IAMCameraControl;
  25 interface IAMCertifiedOutputProtection;
  26 interface IAMClockSlave;
  27 interface IAMCopyCaptureFileProgress;
  28 interface IAMCrossbar;
  29 interface IAMDevMemoryAllocator;
  30 interface IAMDevMemoryControl;
  31 interface IAMDroppedFrames;
  32 interface IAMExtDevice;
  33 interface IAMExtTransport;
  34 interface IAMGraphStreams;
  35 interface IAMLatency;
  36 interface IAMOpenProgress;
  37 interface IAMOverlayFX;
  38 interface IAMPhysicalPinInfo;
  39 interface IAMPushSource;
  40 interface IAMStreamConfig;
  41 interface IAMTimecodeDisplay;
  42 interface IAMTimecodeGenerator;
  43 interface IAMTimecodeReader;
  44 interface IAMTVTuner;
  45 interface IAMVfwCaptureDialogs;
  46 interface IAMVfwCompressDialogs;
  47 interface IAMVideoCompression;
  48 interface IAMVideoDecimationProperties;
  49 interface IAMVideoProcAmp;
  50 interface IAMGraphBuilderCallback;
  51 interface ICaptureGraphBuilder;
  52 interface ICaptureGraphBuilder2;
  53 interface IConfigAviMux;
  54 interface IConfigInterleaving;
  55 interface IDecimateVideoImage;
  56 interface IDrawVideoImage;
  57 interface IEnumRegFilters;
  58 interface IEnumStreamIdMap;
  59 interface IFileSourceFilter;
  60 interface IFileSinkFilter;
  61 interface IFileSinkFilter2;
  62 interface IFilterMapper;
  63 interface IFilterMapper2;
  64 interface IGraphBuilder;
  65 interface IKsPropertySet;
  66 interface IMediaEventSink;
  67 interface IMpeg2Demultiplexer;
  68 interface IMPEG2StreamIdMap;
  69 interface IOverlay;
  70 interface IOverlayNotify;
  71 interface IOverlayNotify2;
  72 interface IQualityControl;
  73 interface ISeekingPassThru;
  74
  75 typedef struct
  76 {
  77     CLSID Clsid;
  78     LPWSTR Name;
  79 } REGFILTER;
  80
  81 [
  82 object,
  83 uuid(56a868a4-0ad4-11ce-b03a-0020af0ba770),
  84 pointer_default(unique)
  85 ]
  86 interface IEnumRegFilters : IUnknown
  87 {
  88     HRESULT Next
  89         ( [in]  ULONG cFilters,
  90           [out] REGFILTER ** apRegFilter,
  91           [out] ULONG * pcFetched
  92         );
  93
  94     HRESULT Skip(
  95         [in] ULONG cFilters
  96     );
  97
  98     HRESULT Reset(void);
  99
 100     HRESULT Clone(
 101         [out] IEnumRegFilters **ppEnum
 102     );
 103 }
 104
 105
 106 typedef IEnumRegFilters *PENUMREGFILTERS;
 107
 108 [
 109 object,
 110 uuid(56a868a3-0ad4-11ce-b03a-0020af0ba770),
 111 pointer_default(unique)
 112 ]
 113 interface IFilterMapper : IUnknown
 114 {
 115     enum { MERIT_PREFERRED     = 0x800000,
 116            MERIT_NORMAL        = 0x600000,
 117            MERIT_UNLIKELY      = 0x400000,
 118            MERIT_DO_NOT_USE    = 0x200000,
 119            MERIT_SW_COMPRESSOR = 0x100000,
 120            MERIT_HW_COMPRESSOR = 0x100050
 121          };
 122
 123     HRESULT RegisterFilter
 124         ( [in] CLSID   clsid,
 125           [in] LPCWSTR Name,
 126           [in] DWORD   dwMerit
 127         );
 128
 129     HRESULT RegisterFilterInstance
 130         ( [in]  CLSID  clsid,
 131           [in]  LPCWSTR Name,
 132           [out] CLSID *MRId
 133         );
 134
 135
 136     HRESULT RegisterPin
 137         ( [in] CLSID   Filter,
 138           [in] LPCWSTR Name,
 139           [in] BOOL    bRendered,
 140           [in] BOOL    bOutput,
 141           [in] BOOL    bZero,
 142           [in] BOOL    bMany,
 143           [in] CLSID   ConnectsToFilter,
 144           [in] LPCWSTR ConnectsToPin
 145         );
 146
 147     HRESULT RegisterPinType
 148         ( [in] CLSID   clsFilter,
 149           [in] LPCWSTR strName,
 150           [in] CLSID   clsMajorType,
 151           [in] CLSID   clsSubType
 152         );
 153
 154
 155     HRESULT UnregisterFilter
 156         ( [in] CLSID  Filter
 157         );
 158
 159
 160     HRESULT UnregisterFilterInstance
 161         ( [in] CLSID  MRId
 162         );
 163
 164
 165     HRESULT UnregisterPin
 166         ( [in] CLSID   Filter,
 167           [in] LPCWSTR Name
 168         );
 169
 170     HRESULT EnumMatchingFilters
 171        ( [out] IEnumRegFilters **ppEnum,
 172          [in]  DWORD dwMerit,
 173          [in]  BOOL  bInputNeeded,
 174          [in]  CLSID clsInMaj,
 175          [in]  CLSID clsInSub,
 176          [in]  BOOL  bRender,
 177          [in]  BOOL  bOututNeeded,
 178          [in]  CLSID clsOutMaj,
 179          [in]  CLSID clsOutSub
 180        );
 181
 182 }
 183
 184 typedef struct
 185 {
 186     const CLSID * clsMajorType;
 187     const CLSID * clsMinorType;
 188 } REGPINTYPES;
 189
 190 typedef struct
 191 {
 192     LPWSTR           strName;
 193     BOOL             bRendered;
 194     BOOL             bOutput;
 195     BOOL             bZero;
 196     BOOL             bMany;
 197     const CLSID *    clsConnectsToFilter;
 198     const WCHAR *    strConnectsToPin;
 199     UINT             nMediaTypes;
 200     const REGPINTYPES * lpMediaType;
 201 } REGFILTERPINS;
 202
 203 typedef struct
 204 {
 205     CLSID clsMedium;
 206     DWORD dw1;
 207     DWORD dw2;
 208 } REGPINMEDIUM;
 209
 210 enum
 211 {
 212     REG_PINFLAG_B_ZERO = 0x1,
 213     REG_PINFLAG_B_RENDERER = 0x2,
 214     REG_PINFLAG_B_MANY = 0x4,
 215     REG_PINFLAG_B_OUTPUT = 0x8
 216 };
 217
 218
 219 typedef struct
 220 {
 221     DWORD dwFlags;
 222     UINT             cInstances;
 223     UINT             nMediaTypes;
 224     [size_is(nMediaTypes)] const REGPINTYPES * lpMediaType;
 225     UINT             nMediums;
 226     [size_is(nMediums)] const REGPINMEDIUM *lpMedium;
 227     const CLSID      *clsPinCategory;
 228 } REGFILTERPINS2;
 229
 230 typedef struct
 231 {
 232     DWORD dwVersion;
 233     DWORD dwMerit;
 234     [switch_is(dwVersion)] [switch_type(DWORD)] union
 235     {
 236         [case(1)]
 237             struct
 238             {
 239                 ULONG cPins;
 240                 [size_is(cPins)] const REGFILTERPINS *rgPins;
 241             };
 242
 243         [case(2)]
 244             struct
 245             {
 246                 ULONG cPins2;
 247                 [size_is(cPins2)] const REGFILTERPINS2 *rgPins2;
 248             };
 249
 250         [default]
 251             ;
 252     };
 253
 254 } REGFILTER2;
 255
 256
 257 [
 258 object,
 259 uuid(b79bb0b0-33c1-11d1-abe1-00a0c905f375),
 260 pointer_default(unique)
 261 ]
 262 interface IFilterMapper2 : IUnknown
 263 {
 264     HRESULT CreateCategory
 265         ( [in] REFCLSID clsidCategory,
 266           [in] DWORD dwCategoryMerit,
 267           [in] LPCWSTR Description
 268           );
 269
 270     HRESULT UnregisterFilter
 271         ( [in] const CLSID *pclsidCategory,
 272           [in] LPCOLESTR szInstance,
 273           [in] REFCLSID Filter
 274         );
 275
 276     HRESULT RegisterFilter
 277         ( [in] REFCLSID clsidFilter,
 278           [in] LPCWSTR Name,
 279           [in, out] IMoniker **ppMoniker,
 280           [in] const CLSID *pclsidCategory,
 281           [in] LPCOLESTR szInstance,
 282           [in] const REGFILTER2 *prf2
 283         );
 284
 285     HRESULT EnumMatchingFilters
 286        ( [out] IEnumMoniker **ppEnum,
 287          [in]  DWORD dwFlags,
 288          [in]  BOOL bExactMatch,
 289          [in]  DWORD dwMerit,
 290          [in]  BOOL  bInputNeeded,
 291          [in]  DWORD cInputTypes,
 292          [size_is(cInputTypes*2)]  const GUID *pInputTypes,
 293          [in]  const REGPINMEDIUM *pMedIn,
 294          [in]  const CLSID *pPinCategoryIn,
 295          [in]  BOOL  bRender,
 296          [in]  BOOL  bOutputNeeded,
 297          [in]  DWORD cOutputTypes,
 298          [size_is(cOutputTypes*2)]  const GUID *pOutputTypes,
 299          [in]  const REGPINMEDIUM *pMedOut,
 300          [in]  const CLSID *pPinCategoryOut
 301        );
 302 }
 303
 304 [
 305 object,
 306 uuid(b79bb0b1-33c1-11d1-abe1-00a0c905f375),
 307 pointer_default(unique)
 308 ]
 309 interface IFilterMapper3 : IFilterMapper2
 310 {
 311     HRESULT GetICreateDevEnum( [out] ICreateDevEnum **ppEnum );
 312 }
 313
 314 typedef enum tagQualityMessageType
 315 {
 316     Famine,
 317     Flood
 318 } QualityMessageType;
 319
 320 typedef struct tagQuality
 321 {
 322     QualityMessageType Type;
 323     LONG               Proportion;
 324     REFERENCE_TIME       Late;
 325     REFERENCE_TIME       TimeStamp;
 326 } Quality;
 327
 328 typedef IQualityControl *PQUALITYCONTROL;
 329
 330 [
 331 object,
 332 uuid(56a868a5-0ad4-11ce-b03a-0020af0ba770),
 333 pointer_default(unique)
 334 ]
 335 interface IQualityControl : IUnknown
 336 {
 337     HRESULT Notify
 338         ( [in] IBaseFilter * pSelf,
 339           [in] Quality q
 340         );
 341
 342     HRESULT SetSink
 343         ( [in] IQualityControl * piqc
 344         );
 345 }
 346
 347 enum
 348 {
 349     CK_NOCOLORKEY  = 0x0,
 350     CK_INDEX       = 0x1,
 351     CK_RGB         = 0x2
 352 };
 353
 354 typedef struct tagCOLORKEY
 355 {
 356     DWORD    KeyType;
 357     DWORD    PaletteIndex;
 358     COLORREF LowColorValue;
 359     COLORREF HighColorValue;
 360 } COLORKEY;
 361
 362 enum
 363 {
 364     ADVISE_NONE = 0x0,
 365     ADVISE_CLIPPING = 0x1,
 366     ADVISE_PALETTE = 0x2,
 367     ADVISE_COLORKEY = 0x4,
 368     ADVISE_POSITION = 0x8,
 369     ADVISE_DISPLAY_CHANGE = 0x10
 370 };
 371
 372 const DWORD ADVISE_ALL = ADVISE_CLIPPING |
 373                          ADVISE_PALETTE  |
 374                          ADVISE_COLORKEY |
 375                          ADVISE_POSITION;
 376
 377 const DWORD ADVISE_ALL2 = ADVISE_ALL |
 378                           ADVISE_DISPLAY_CHANGE;
 379
 380 cpp_quote("#ifndef _WINGDI_")
 381
 382 /* already defined in wingdi.h, but needed for WIDL */
 383
 384 typedef struct _RGNDATAHEADER
 385 {
 386     DWORD dwSize;
 387     DWORD iType;
 388     DWORD nCount;
 389     DWORD nRgnSize;
 390     RECT  rcBound;
 391 } RGNDATAHEADER;
 392
 393 typedef struct _RGNDATA
 394 {
 395     RGNDATAHEADER rdh;
 396     char Buffer[1];
 397 } RGNDATA;
 398
 399 cpp_quote("#endif /* _WINGDI_ */")
 400
 401 [
 402 object,
 403 local,
 404 uuid(56a868a0-0ad4-11ce-b03a-0020af0ba770),
 405 pointer_default(unique)
 406 ]
 407 interface IOverlayNotify : IUnknown
 408 {
 409     HRESULT OnPaletteChange(
 410         [in] DWORD dwColors,
 411         [in] const PALETTEENTRY *pPalette);
 412
 413     HRESULT OnClipChange(
 414         [in] const RECT *pSourceRect,
 415         [in] const RECT *pDestinationRect,
 416         [in] const RGNDATA *pRgnData);
 417
 418     HRESULT OnColorKeyChange([in] const COLORKEY *pColorKey);
 419
 420     HRESULT OnPositionChange([in] const RECT *pSourceRect,
 421                              [in] const RECT *pDestinationRect);
 422 }
 423
 424 typedef IOverlayNotify *POVERLAYNOTIFY;
 425
 426 cpp_quote("#if 0")
 427 typedef HANDLE HMONITOR;
 428 cpp_quote("#endif /* 0 */")
 429
 430 [
 431 object,
 432 local,
 433 uuid(680EFA10-D535-11D1-87C8-00A0C9223196),
 434 pointer_default(unique)
 435 ]
 436 interface IOverlayNotify2 : IOverlayNotify
 437 {
 438     HRESULT OnDisplayChange(
 439         HMONITOR hMonitor);
 440 }
 441
 442 typedef IOverlayNotify2 *POVERLAYNOTIFY2;
 443
 444 [
 445 object,
 446 local,
 447 uuid(56a868a1-0ad4-11ce-b03a-0020af0ba770),
 448 pointer_default(unique)
 449 ]
 450 interface IOverlay : IUnknown
 451 {
 452     HRESULT GetPalette(
 453         [out] DWORD *pdwColors,
 454         [out] PALETTEENTRY **ppPalette);
 455
 456     HRESULT SetPalette(
 457         [in] DWORD dwColors,
 458         [in] PALETTEENTRY *pPalette);
 459
 460     HRESULT GetDefaultColorKey([out] COLORKEY *pColorKey);
 461
 462     HRESULT GetColorKey([out] COLORKEY *pColorKey);
 463
 464     HRESULT SetColorKey([in,out] COLORKEY *pColorKey);
 465
 466     HRESULT GetWindowHandle([out] HWND *pHwnd);
 467
 468     HRESULT GetClipList([out] RECT *pSourceRect,
 469                         [out] RECT *pDestinationRect,
 470                         [out] RGNDATA **ppRgnData);
 471
 472     HRESULT GetVideoPosition([out] RECT *pSourceRect,
 473                              [out] RECT *pDestinationRect);
 474
 475     HRESULT Advise(
 476         [in] IOverlayNotify *pOverlayNotify,
 477         [in] DWORD dwInterests);
 478
 479     HRESULT Unadvise();
 480 }
 481
 482 typedef IOverlay *POVERLAY;
 483
 484 [
 485 object,
 486 uuid(56a868a2-0ad4-11ce-b03a-0020af0ba770),
 487 pointer_default(unique)
 488 ]
 489 interface IMediaEventSink : IUnknown
 490 {
 491     HRESULT Notify(
 492         [in] LONG EventCode,
 493         [in] LONG_PTR EventParam1,
 494         [in] LONG_PTR EventParam2
 495     );
 496 }
 497
 498 typedef IMediaEventSink *PMEDIAEVENTSINK;
 499
 500 [
 501 object,
 502 uuid(56a868a6-0ad4-11ce-b03a-0020af0ba770),
 503 pointer_default(unique)
 504 ]
 505 interface IFileSourceFilter : IUnknown
 506 {
 507     HRESULT Load(
 508         [in] LPCOLESTR pszFileName,
 509         [in, unique] const AM_MEDIA_TYPE *pmt
 510     );
 511
 512     HRESULT GetCurFile(
 513         [out] LPOLESTR *ppszFileName,
 514         [out] AM_MEDIA_TYPE *pmt
 515     );
 516 }
 517
 518 typedef IFileSourceFilter *PFILTERFILESOURCE;
 519
 520 [
 521 object,
 522 uuid(a2104830-7c70-11cf-8bce-00aa00a3f1a6),
 523 pointer_default(unique)
 524 ]
 525 interface IFileSinkFilter : IUnknown
 526 {
 527     HRESULT SetFileName(
 528         [in] LPCOLESTR pszFileName,
 529         [in, unique] const AM_MEDIA_TYPE *pmt
 530     );
 531
 532     HRESULT GetCurFile(
 533         [out] LPOLESTR *ppszFileName,
 534         [out] AM_MEDIA_TYPE *pmt
 535     );
 536 }
 537
 538 typedef IFileSinkFilter *PFILTERFILESINK;
 539
 540 [
 541         object,
 542         uuid(00855B90-CE1B-11d0-BD4F-00A0C911CE86),
 543         pointer_default(unique)
 544 ]
 545 interface IFileSinkFilter2 : IFileSinkFilter
 546 {
 547     HRESULT SetMode(
 548         [in] DWORD dwFlags
 549     );
 550
 551     HRESULT GetMode(
 552         [out] DWORD *pdwFlags
 553     );
 554 }
 555
 556 typedef IFileSinkFilter2 *PFILESINKFILTER2;
 557
 558 typedef enum
 559 {
 560     AM_FILE_OVERWRITE = 0x00000001,
 561 } AM_FILESINK_FLAGS;
 562
 563 [
 564 object,
 565 uuid(56a868a9-0ad4-11ce-b03a-0020af0ba770),
 566 pointer_default(unique)
 567 ]
 568 interface IGraphBuilder : IFilterGraph
 569 {
 570     HRESULT Connect
 571         ( [in] IPin * ppinOut,
 572           [in] IPin * ppinIn
 573         );
 574
 575     HRESULT Render
 576         ( [in] IPin * ppinOut
 577         );
 578
 579     HRESULT RenderFile
 580         ( [in] LPCWSTR lpcwstrFile,
 581           [in, unique] LPCWSTR lpcwstrPlayList
 582         );
 583
 584     HRESULT AddSourceFilter
 585         ( [in]      LPCWSTR lpcwstrFileName,
 586           [in, unique]      LPCWSTR lpcwstrFilterName,
 587           [out]     IBaseFilter* *ppFilter
 588         );
 589
 590     HRESULT SetLogFile
 591         ( [in]      DWORD_PTR hFile
 592         );
 593
 594     HRESULT Abort();
 595
 596     HRESULT ShouldOperationContinue();
 597 }
 598
 599
 600 [
 601     object,
 602     uuid(bf87b6e0-8c27-11d0-b3f0-00aa003761c5),
 603     pointer_default(unique)
 604 ]
 605 interface ICaptureGraphBuilder : IUnknown {
 606
 607     HRESULT SetFiltergraph(
 608         [in] IGraphBuilder *pfg);
 609
 610     HRESULT GetFiltergraph(
 611         [out] IGraphBuilder **ppfg);
 612
 613     HRESULT SetOutputFileName(
 614         [in] const GUID *pType,
 615         [in] LPCOLESTR lpstrFile,
 616         [out] IBaseFilter **ppf,
 617         [out] IFileSinkFilter **ppSink);
 618
 619     [local] HRESULT FindInterface(
 620         [in, unique] const GUID *pCategory,
 621         [in] IBaseFilter *pf,
 622         [in] REFIID riid,
 623         [out] void **ppint);
 624
 625     [call_as(FindInterface)] HRESULT RemoteFindInterface(
 626         [in, unique] const GUID *pCategory,
 627         [in] IBaseFilter *pf,
 628         [in] REFIID riid,
 629         [out] IUnknown **ppint);
 630
 631     HRESULT RenderStream(
 632         [in] const GUID *pCategory,
 633         [in] IUnknown *pSource,
 634         [in] IBaseFilter *pfCompressor,
 635         [in] IBaseFilter *pfRenderer);
 636
 637     HRESULT ControlStream(
 638         [in] const GUID *pCategory,
 639         [in] IBaseFilter *pFilter,
 640         [in] REFERENCE_TIME *pstart,
 641         [in] REFERENCE_TIME *pstop,
 642         [in] WORD wStartCookie,
 643         [in] WORD wStopCookie);
 644
 645     HRESULT AllocCapFile(
 646         [in] LPCOLESTR lpstr,
 647         [in] DWORDLONG dwlSize);
 648
 649     HRESULT CopyCaptureFile(
 650         [in] LPOLESTR lpwstrOld,
 651         [in] LPOLESTR lpwstrNew,
 652         [in] int fAllowEscAbort,
 653         [in] IAMCopyCaptureFileProgress *pCallback);
 654 }
 655
 656 [
 657 object,
 658 uuid(670d1d20-a068-11d0-b3f0-00aa003761c5),
 659 pointer_default(unique)
 660 ]
 661 interface IAMCopyCaptureFileProgress : IUnknown
 662 {
 663     HRESULT Progress(
 664         [in] int iProgress);
 665 }
 666
 667 [
 668     object,
 669     uuid(93E5A4E0-2D50-11d2-ABFA-00A0C9C6E38D),
 670     pointer_default(unique)
 671 ]
 672 interface ICaptureGraphBuilder2 : IUnknown
 673 {
 674     HRESULT SetFiltergraph(
 675         [in] IGraphBuilder *pfg);
 676
 677     HRESULT GetFiltergraph(
 678         [out] IGraphBuilder **ppfg);
 679
 680     HRESULT SetOutputFileName(
 681         [in] const GUID *pType,
 682         [in] LPCOLESTR lpstrFile,
 683         [out] IBaseFilter **ppf,
 684         [out] IFileSinkFilter **ppSink);
 685
 686     [local] HRESULT FindInterface(
 687         [in] const GUID *pCategory,
 688         [in] const GUID *pType,
 689         [in] IBaseFilter *pf,
 690         [in] REFIID riid,
 691         [out] void **ppint);
 692
 693     [call_as(FindInterface)] HRESULT RemoteFindInterface(
 694         [in] const GUID *pCategory,
 695         [in] const GUID *pType,
 696         [in] IBaseFilter *pf,
 697         [in] REFIID riid,
 698         [out] IUnknown **ppint);
 699
 700     HRESULT RenderStream(
 701         [in] const GUID *pCategory,
 702         [in] const GUID *pType,
 703         [in] IUnknown *pSource,
 704         [in] IBaseFilter *pfCompressor,
 705         [in] IBaseFilter *pfRenderer);
 706
 707     HRESULT ControlStream(
 708         [in] const GUID *pCategory,
 709         [in] const GUID *pType,
 710         [in] IBaseFilter *pFilter,
 711         [in] REFERENCE_TIME *pstart,
 712         [in] REFERENCE_TIME *pstop,
 713         [in] WORD wStartCookie,
 714         [in] WORD wStopCookie);
 715
 716     HRESULT AllocCapFile(
 717         [in] LPCOLESTR lpstr,
 718         [in] DWORDLONG dwlSize);
 719
 720     HRESULT CopyCaptureFile(
 721         [in] LPOLESTR lpwstrOld,
 722         [in] LPOLESTR lpwstrNew,
 723         [in] int fAllowEscAbort,
 724         [in] IAMCopyCaptureFileProgress *pCallback);
 725
 726     HRESULT FindPin(
 727         [in] IUnknown *pSource,
 728         [in] PIN_DIRECTION pindir,
 729         [in] const GUID *pCategory,
 730         [in] const GUID *pType,
 731         [in] BOOL fUnconnected,
 732         [in] int num,
 733         [out] IPin **ppPin);
 734 }
 735
 736 [
 737     local,
 738     object,
 739     uuid(9fd52741-176d-4b36-8f51-ca8f933223be),
 740     pointer_default(unique)
 741 ]
 742 interface IAMClockSlave : IUnknown
 743 {
 744     HRESULT SetErrorTolerance(
 745         [in] DWORD dwTolerance);
 746
 747     HRESULT GetErrorTolerance(
 748         [out] DWORD *pdwTolerance);
 749 };
 750
 751 typedef struct _AMCOPPSignature {
 752     BYTE Signature[256];
 753 } AMCOPPSignature;
 754
 755 typedef struct _AMCOPPCommand {
 756     GUID macKDI;
 757     GUID guidCommandID;
 758     DWORD dwSequence;
 759     DWORD bSizeData;
 760     BYTE CommandData[4056];
 761 } AMCOPPCommand, *LPAMCOPPCommand;
 762
 763 typedef struct _AMCOPPStatusInput {
 764     GUID rApp;
 765     GUID guidStatusRequestID;
 766     DWORD dwSequence;
 767     DWORD cbSizeData;
 768     BYTE StatusData[4056];
 769 } AMCOPPStatusInput, *LPAMCOPPStatusInput;
 770
 771 typedef struct _AMCOPPStatusOutput {
 772     GUID macKDI;
 773     DWORD cbSizeData;
 774     BYTE COPPStatus[4076];
 775 } AMCOPPStatusOutput, *LPAMCOPPStatusOutput;
 776
 777 [
 778     local,
 779     object,
 780     uuid(6feded3e-0ff1-4901-a2f1-43f7012c8515),
 781     pointer_default(unique)
 782 ]
 783 interface IAMCertifiedOutputProtection : IUnknown
 784 {
 785     HRESULT KeyExchange (
 786         [out] GUID* pRandom,
 787         [out] BYTE** VarLenCertGH,
 788         [out] DWORD* pdwLengthCertGH);
 789
 790     HRESULT SessionSequenceStart(
 791         [in] AMCOPPSignature* pSig);
 792
 793     HRESULT ProtectionCommand(
 794         [in] const AMCOPPCommand* cmd);
 795
 796     HRESULT ProtectionStatus(
 797         [in] const AMCOPPStatusInput* pStatusInput,
 798         [out] AMCOPPStatusOutput* pStatusOutput);
 799 };
 800
 801 enum _AM_RENSDEREXFLAGS
 802 {
 803     AM_RENDEREX_RENDERTOEXISTINGRENDERERS = 0x01
 804 };
 805
 806 [
 807     object,
 808     uuid(36b73882-c2c8-11cf-8b46-00805f6cef60),
 809     pointer_default(unique)
 810 ]
 811 interface IFilterGraph2: IGraphBuilder
 812 {
 813     HRESULT AddSourceFilterForMoniker(
 814           [in] IMoniker *pMoniker,
 815           [in] IBindCtx *pCtx,
 816           [in, unique] LPCWSTR lpcwstrFilterName,
 817           [out] IBaseFilter **ppFilter
 818     );
 819
 820     HRESULT ReconnectEx
 821         ( [in] IPin * ppin,
 822           [in, unique] const AM_MEDIA_TYPE *pmt
 823         );
 824
 825     HRESULT RenderEx( [in] IPin *pPinOut,
 826                       [in] DWORD dwFlags,
 827                       [in, out] DWORD *pvContext
 828                     );
 829 }
 830
 831 [
 832     object,
 833     local,
 834     uuid(56a868bf-0ad4-11ce-b03a-0020af0ba770),
 835     pointer_default(unique)
 836 ]
 837 interface IStreamBuilder : IUnknown
 838 {
 839     HRESULT Render
 840         ( [in] IPin * ppinOut,
 841           [in] IGraphBuilder * pGraph
 842         );
 843
 844     HRESULT Backout
 845         ( [in] IPin * ppinOut,
 846           [in] IGraphBuilder * pGraph
 847         );
 848 }
 849
 850
 851 /*****************************************************************************
 852  * IAMStreamConfig interface
 853  */
 854 [
 855     object,
 856     uuid(c6e13340-30ac-11d0-a18c-00a0c9118956),
 857     pointer_default(unique)
 858 ]
 859 interface IAMStreamConfig : IUnknown
 860 {
 861     typedef struct _VIDEO_STREAM_CONFIG_CAPS {
 862         GUID  guid;
 863         ULONG VideoStandard;
 864         SIZE  InputSize;
 865         SIZE  MinCroppingSize;
 866         SIZE  MaxCroppingSize;
 867         int   CropGranularityX;
 868         int   CropGranularityY;
 869         int   CropAlignX;
 870         int   CropAlignY;
 871         SIZE  MinOutputSize;
 872         SIZE  MaxOutputSize;
 873         int   OutputGranularityX;
 874         int   OutputGranularityY;
 875         int   StretchTapsX;
 876         int   StretchTapsY;
 877         int   ShrinkTapsX;
 878         int   ShrinkTapsY;
 879         LONGLONG MinFrameInterval;
 880         LONGLONG MaxFrameInterval;
 881         LONG  MinBitsPerSecond;
 882         LONG  MaxBitsPerSecond;
 883     } VIDEO_STREAM_CONFIG_CAPS;
 884
 885     typedef struct _AUDIO_STREAM_CONFIG_CAPS {
 886         GUID guid;
 887         ULONG MinimumChannels;
 888         ULONG MaximumChannels;
 889         ULONG ChannelsGranularity;
 890         ULONG MinimumBitsPerSample;
 891         ULONG MaximumBitsPerSample;
 892         ULONG BitsPerSampleGranularity;
 893         ULONG MinimumSampleFrequency;
 894         ULONG MaximumSampleFrequency;
 895         ULONG SampleFrequencyGranularity;
 896     } AUDIO_STREAM_CONFIG_CAPS;
 897
 898     HRESULT SetFormat( [in] AM_MEDIA_TYPE *pmt);
 899     HRESULT GetFormat( [in] AM_MEDIA_TYPE **pmt);
 900     HRESULT GetNumberOfCapabilities( [out] int *piCount, [out] int *piSize);
 901     HRESULT GetStreamCaps( [in] int iIndex, [out] AM_MEDIA_TYPE **pmt,
 902                           [out] BYTE *pSCC);
 903 }
 904
 905
 906 typedef enum tagVideoProcAmpProperty
 907 {
 908     VideoProcAmp_Brightness,
 909     VideoProcAmp_Contrast,
 910     VideoProcAmp_Hue,
 911     VideoProcAmp_Saturation,
 912     VideoProcAmp_Sharpness,
 913     VideoProcAmp_Gamma,
 914     VideoProcAmp_ColorEnable,
 915     VideoProcAmp_WhiteBalance,
 916     VideoProcAmp_BacklightCompensation,
 917     VideoProcAmp_Gain
 918 } VideoProcAmpProperty;
 919
 920 typedef enum tagVideoProcAmpFlags
 921 {
 922     VideoProcAmp_Flags_Auto   = 0x0001,
 923     VideoProcAmp_Flags_Manual = 0x0002,
 924 } VideoProcAmpFlags;
 925
 926 /*****************************************************************************
 927  * IAMVideoProcAmp interface
 928  */
 929 [
 930     object,
 931     uuid(c6e13360-30ac-11d0-a18c-00a0c9118956),
 932     pointer_default(unique)
 933 ]
 934 interface IAMVideoProcAmp : IUnknown
 935 {
 936     HRESULT GetRange( [in] LONG Property, [out] LONG *pMin, [out] LONG *pMax,
 937                      [out] LONG *pSteppingDelta, [out] LONG *pDefault,
 938                      [out] LONG *pCapsFlags);
 939     HRESULT Set( [in] LONG Property, [in] LONG lValue, [in] LONG Flags);
 940     HRESULT Get( [in] LONG Property, [out] LONG *lValue, [out] LONG *Flags);
 941 }
 942
 943
 944 [
 945         object,
 946         uuid(56a868aa-0ad4-11ce-b03a-0020af0ba770),
 947         pointer_default(unique)
 948 ]
 949 interface IAsyncReader : IUnknown
 950 {
 951     HRESULT RequestAllocator(
 952                 [in]  IMemAllocator* pPreferred,
 953                 [in]  ALLOCATOR_PROPERTIES* pProps,
 954                 [out] IMemAllocator ** ppActual);
 955
 956     HRESULT Request(
 957                 [in] IMediaSample* pSample,
 958                 [in] DWORD_PTR dwUser);
 959
 960     HRESULT WaitForNext(
 961                 [in]  DWORD dwTimeout,
 962                 [out] IMediaSample** ppSample,
 963                 [out] DWORD_PTR * pdwUser);
 964
 965     HRESULT SyncReadAligned(
 966                 [in] IMediaSample* pSample);
 967
 968     HRESULT SyncRead(
 969                 [in]  LONGLONG llPosition,
 970                 [in]  LONG lLength,
 971                 [out, size_is(lLength)]
 972                       BYTE* pBuffer);
 973
 974     HRESULT Length(
 975                 [out] LONGLONG* pTotal,
 976                 [out] LONGLONG* pAvailable);
 977
 978     HRESULT BeginFlush(void);
 979
 980     HRESULT EndFlush(void);
 981 }
 982
 983
 984 [
 985     object,
 986     uuid(56a868ab-0ad4-11ce-b03a-0020af0ba770),
 987     pointer_default(unique)
 988 ]
 989 interface IGraphVersion : IUnknown
 990 {
 991     HRESULT QueryVersion(LONG* pVersion);
 992 }
 993
 994 [
 995     object,
 996     uuid(56a868ad-0ad4-11ce-b03a-0020af0ba770),
 997     pointer_default(unique)
 998 ]
 999 interface IResourceConsumer : IUnknown
1000 {
1001     HRESULT AcquireResource(
1002         [in] LONG idResource);
1003
1004     HRESULT ReleaseResource(
1005         [in] LONG idResource);
1006 }
1007
1008
1009 [
1010     object,
1011     uuid(56a868ac-0ad4-11ce-b03a-0020af0ba770),
1012     pointer_default(unique)
1013 ]
1014 interface IResourceManager : IUnknown
1015 {
1016     HRESULT Register(
1017         [in] LPCWSTR pName,
1018         [in] LONG   cResource,
1019         [out] LONG* plToken
1020         );
1021
1022     HRESULT RegisterGroup(
1023         [in] LPCWSTR pName,
1024         [in] LONG cResource,
1025         [in, size_is(cResource)]
1026              LONG* palTokens,
1027         [out] LONG* plToken
1028         );
1029
1030     HRESULT RequestResource(
1031         [in] LONG idResource,
1032         [in] IUnknown* pFocusObject,
1033         [in] IResourceConsumer* pConsumer
1034         );
1035
1036     HRESULT NotifyAcquire(
1037         [in] LONG idResource,
1038         [in] IResourceConsumer* pConsumer,
1039         [in] HRESULT hr);
1040
1041     HRESULT NotifyRelease(
1042         [in] LONG idResource,
1043         [in] IResourceConsumer* pConsumer,
1044         [in] BOOL bStillWant);
1045
1046     HRESULT CancelRequest(
1047         [in] LONG idResource,
1048         [in] IResourceConsumer* pConsumer);
1049
1050     HRESULT SetFocus(
1051         [in] IUnknown* pFocusObject);
1052
1053     HRESULT ReleaseFocus(
1054         [in] IUnknown* pFocusObject);
1055
1056 }
1057
1058 cpp_quote("#ifndef _IKsPropertySet_")
1059 cpp_quote("#define _IKsPropertySet_")
1060 cpp_quote("#define KSPROPERTY_SUPPORT_GET  1")
1061 cpp_quote("#define KSPROPERTY_SUPPORT_SET  2")
1062
1063 [
1064     object,
1065     uuid(31efac30-515c-11d0-a9aa-00aa0061be93),
1066     pointer_default(unique),
1067     local
1068 ]
1069 interface IKsPropertySet : IUnknown
1070 {
1071     HRESULT Set( [in] REFGUID guidPropSet,
1072                  [in] DWORD dwPropID,
1073                  [in, size_is(cbInstanceData)] LPVOID pInstanceData,
1074                  [in] DWORD cbInstanceData,
1075                  [in, size_is(cbPropData)] LPVOID pPropData,
1076                  [in] DWORD cbPropData );
1077
1078     HRESULT Get( [in] REFGUID guidPropSet,
1079                  [in] DWORD dwPropID,
1080                  [in, size_is(cbInstanceData)] LPVOID pInstanceData,
1081                  [in] DWORD cbInstanceData,
1082                  [out, size_is(cbPropData)] LPVOID pPropData,
1083                  [in] DWORD cbPropData,
1084                  [out] DWORD *pcbReturned );
1085
1086     HRESULT QuerySupported( [in] REFGUID guidPropSet,
1087                             [in] DWORD dwPropID,
1088                             [out] DWORD *pTypeSupport);
1089 }
1090 cpp_quote("#endif /* _IKsPropertySet_ */")
1091
1092 [
1093     object,
1094     uuid(36b73883-c2c8-11cf-8b46-00805f6cef60),
1095     pointer_default(unique)
1096 ]
1097 interface ISeekingPassThru : IUnknown
1098 {
1099     HRESULT Init( [in] BOOL bSupportRendering, [in] IPin *pPin);
1100 }
1101
1102 enum _AM_FILTER_MISC_FLAGS
1103 {
1104     AM_FILTER_MISC_FLAGS_IS_RENDERER = 0x1,
1105     AM_FILTER_MISC_FLAGS_IS_SOURCE = 0x2
1106 };
1107
1108 [
1109     local,
1110     object,
1111     uuid(2dd74950-a890-11d1-abe8-00a0c905f375),
1112     pointer_default(unique)
1113 ]
1114 interface IAMFilterMiscFlags : IUnknown
1115 {
1116     ULONG GetMiscFlags();
1117 };
1118
1119 [
1120     local,
1121     object,
1122     uuid(4995f511-9ddb-4f12-bd3b-f04611807b79),
1123     pointer_default(unique)
1124 ]
1125 interface IAMGraphBuilderCallback : IUnknown
1126 {
1127     HRESULT SelectedFilter(
1128         [in] IMoniker *pMon);
1129
1130     HRESULT CreatedFilter(
1131         [in] IBaseFilter *pFil);
1132 };