control.idl 9.69 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
/*
 * Copyright (C) 2002 Lionel Ulmer
 * Copyright (C) 2004 Alexandre Julliard
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
17
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
18 19
 */

20
import "oaidl.idl";
21 22 23 24 25 26 27

interface IMediaControl;
interface IBasicAudio;
interface IBasicVideo;
interface IVideoWindow;
interface IMediaEvent;
interface IMediaEventEx;
28
interface IMediaPosition;
29

30
typedef LONG OAFilterState;
31 32 33
typedef LONG_PTR OAHWND;
typedef LONG_PTR OAEVENT;

34 35 36 37 38
cpp_quote("#ifndef REFTIME_DEFINED")
cpp_quote("#define REFTIME_DEFINED")
typedef DOUBLE REFTIME;
cpp_quote("#endif")

39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70
/*****************************************************************************
 * IMediaControl interface
 */
[
    object,
    uuid(56a868b1-0ad4-11ce-b03a-0020af0ba770),
    pointer_default(unique)
]
interface IMediaControl : IDispatch
{
    HRESULT Run();
    HRESULT Pause();
    HRESULT Stop();
    HRESULT GetState( [in] LONG msTimeout, [out] OAFilterState *pfs );
    HRESULT RenderFile( [in] BSTR strFilename );
    HRESULT AddSourceFilter( [in] BSTR strFilename, [out] IDispatch **ppUnk );
    [propget] HRESULT FilterCollection( [out] IDispatch **ppUnk );
    [propget] HRESULT RegFilterCollection( [out] IDispatch **ppUnk );
    HRESULT StopWhenReady();
}


/*****************************************************************************
 * IBasicAudio interface
 */
[
    object,
    uuid(56a868b3-0ad4-11ce-b03a-0020af0ba770),
    pointer_default(unique)
]
interface IBasicAudio : IDispatch
{
71 72 73 74
    [propput] HRESULT Volume( [in] LONG lVolume );
    [propget] HRESULT Volume( [out] LONG *plVolume );
    [propput] HRESULT Balance( [in] LONG lBalance );
    [propget] HRESULT Balance( [out] LONG *plBalance );
75 76 77 78 79 80 81 82 83 84 85 86 87 88 89
}


/*****************************************************************************
 * IVideoWindow interface
 */
[
    object,
    uuid(56a868b4-0ad4-11ce-b03a-0020af0ba770),
    pointer_default(unique)
]
interface IVideoWindow : IDispatch
{
    [propput] HRESULT Caption( [in] BSTR strCaption );
    [propget] HRESULT Caption( [out] BSTR *strCaption );
90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109
    [propput] HRESULT WindowStyle( [in] LONG WindowStyle );
    [propget] HRESULT WindowStyle( [out] LONG *WindowStyle );
    [propput] HRESULT WindowStyleEx( [in] LONG WindowStyleEx );
    [propget] HRESULT WindowStyleEx( [out] LONG *WindowStyleEx );
    [propput] HRESULT AutoShow( [in] LONG AutoShow );
    [propget] HRESULT AutoShow( [out] LONG *AutoShow );
    [propput] HRESULT WindowState( [in] LONG WindowState );
    [propget] HRESULT WindowState( [out] LONG *WindowState );
    [propput] HRESULT BackgroundPalette( [in] LONG BackgroundPalette );
    [propget] HRESULT BackgroundPalette( [out] LONG *pBackgroundPalette );
    [propput] HRESULT Visible( [in] LONG Visible );
    [propget] HRESULT Visible( [out] LONG *pVisible );
    [propput] HRESULT Left( [in] LONG Left );
    [propget] HRESULT Left( [out] LONG *pLeft );
    [propput] HRESULT Width( [in] LONG Width );
    [propget] HRESULT Width( [out] LONG *pWidth );
    [propput] HRESULT Top( [in] LONG Top );
    [propget] HRESULT Top( [out] LONG *pTop );
    [propput] HRESULT Height( [in] LONG Height );
    [propget] HRESULT Height( [out] LONG *pHeight );
110 111 112 113
    [propput] HRESULT Owner( [in] OAHWND Owner );
    [propget] HRESULT Owner( [out] OAHWND *Owner );
    [propput] HRESULT MessageDrain( [in] OAHWND Drain );
    [propget] HRESULT MessageDrain( [out] OAHWND *Drain );
114 115 116 117 118 119 120 121 122 123 124 125 126
    [propget] HRESULT BorderColor( [out] LONG *Color );
    [propput] HRESULT BorderColor( [in] LONG Color );
    [propget] HRESULT FullScreenMode( [out] LONG *FullScreenMode );
    [propput] HRESULT FullScreenMode( [in] LONG FullScreenMode );
    HRESULT SetWindowForeground( [in] LONG Focus );
    HRESULT NotifyOwnerMessage( [in] OAHWND hwnd, [in] LONG uMsg, [in] LONG_PTR wParam, [in] LONG_PTR lParam );
    HRESULT SetWindowPosition( [in] LONG Left, [in] LONG Top, [in] LONG Width, [in] LONG Height );
    HRESULT GetWindowPosition( [out] LONG *pLeft, [out] LONG *pTop, [out] LONG *pWidth, [out] LONG *pHeight );
    HRESULT GetMinIdealImageSize( [out] LONG *pWidth, [out] LONG *pHeight );
    HRESULT GetMaxIdealImageSize( [out] LONG *pWidth, [out] LONG *pHeight );
    HRESULT GetRestorePosition( [out] LONG *pLeft, [out] LONG *pTop, [out] LONG *pWidth, [out] LONG *pHeight );
    HRESULT HideCursor( [in] LONG HideCursor );
    HRESULT IsCursorHidden( [out] LONG *CursorHidden );
127 128 129 130 131 132 133 134 135 136 137 138 139 140
}


/*****************************************************************************
 * IBasicVideo interface
 */
[
    object,
    uuid(56a868b5-0ad4-11ce-b03a-0020af0ba770),
    pointer_default(unique)
]
interface IBasicVideo : IDispatch
{
    [propget] HRESULT AvgTimePerFrame( [out] REFTIME *pAvgTimePerFrame );
141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162
    [propget] HRESULT BitRate( [out] LONG *pBitRate );
    [propget] HRESULT BitErrorRate( [out] LONG *pBitErrorRate );
    [propget] HRESULT VideoWidth( [out] LONG *pVideoWidth );
    [propget] HRESULT VideoHeight( [out] LONG *pVideoHeight );
    [propput] HRESULT SourceLeft( [in] LONG SourceLeft );
    [propget] HRESULT SourceLeft( [out] LONG *pSourceLeft );
    [propput] HRESULT SourceWidth( [in] LONG SourceWidth );
    [propget] HRESULT SourceWidth( [out] LONG *pSourceWidth );
    [propput] HRESULT SourceTop( [in] LONG SourceTop );
    [propget] HRESULT SourceTop( [out] LONG *pSourceTop );
    [propput] HRESULT SourceHeight( [in] LONG SourceHeight );
    [propget] HRESULT SourceHeight( [out] LONG *pSourceHeight );
    [propput] HRESULT DestinationLeft( [in] LONG DestinationLeft );
    [propget] HRESULT DestinationLeft( [out] LONG *pDestinationLeft );
    [propput] HRESULT DestinationWidth( [in] LONG DestinationWidth );
    [propget] HRESULT DestinationWidth( [out] LONG *pDestinationWidth );
    [propput] HRESULT DestinationTop( [in] LONG DestinationTop );
    [propget] HRESULT DestinationTop( [out] LONG *pDestinationTop );
    [propput] HRESULT DestinationHeight( [in] LONG DestinationHeight );
    [propget] HRESULT DestinationHeight( [out] LONG *pDestinationHeight );
    HRESULT SetSourcePosition( [in] LONG Left, [in] LONG Top, [in] LONG Width, [in] LONG Height );
    HRESULT GetSourcePosition( [out] LONG *pLeft, [out] LONG *pTop, [out] LONG *pWidth, [out] LONG *pHeight );
163
    HRESULT SetDefaultSourcePosition();
164 165
    HRESULT SetDestinationPosition( [in] LONG Left, [in] LONG Top, [in] LONG Width, [in] LONG Height );
    HRESULT GetDestinationPosition( [out] LONG *pLeft, [out] LONG *pTop, [out] LONG *pWidth, [out] LONG *pHeight );
166
    HRESULT SetDefaultDestinationPosition();
167 168 169 170 171 172 173
    HRESULT GetVideoSize( [out] LONG *pWidth, [out] LONG *pHeight );
    HRESULT GetVideoPaletteEntries( [in] LONG StartIndex,
                                    [in] LONG Entries,
                                    [out] LONG *pRetrieved,
                                    [out, size_is(Entries), length_is(*pRetrieved)] LONG *pPalette );
    HRESULT GetCurrentImage( [in, out] LONG *pBufferSize,
                             [out, size_is(*pBufferSize), length_is(*pBufferSize)] LONG *pDIBImage );
174 175 176 177
    HRESULT IsUsingDefaultSource();
    HRESULT IsUsingDefaultDestination();
}

178 179 180 181 182 183 184 185 186 187 188
[
    uuid(329bb360-f6ea-11d1-9038-00a0c9697298),
    helpstring("IBasicVideo2"),
    odl
]

interface IBasicVideo2 : IBasicVideo
{
    HRESULT GetPreferredAspectRatio([out] LONG *plAspectX, [out] LONG *plAspectY);
}

189 190 191 192 193 194 195 196 197 198 199 200

/*****************************************************************************
 * IMediaEvent interface
 */
[
    object,
    uuid(56a868b6-0ad4-11ce-b03a-0020af0ba770),
    pointer_default(unique)
]
interface IMediaEvent : IDispatch
{
    HRESULT GetEventHandle( [out] OAEVENT *hEvent );
201 202 203 204 205
    HRESULT GetEvent( [out] LONG *lEventCode, [out] LONG_PTR *lParam1, [out] LONG_PTR *lParam2, [in] LONG msTimeout );
    HRESULT WaitForCompletion( [in] LONG msTimeout, [out] LONG *pEvCode );
    HRESULT CancelDefaultHandling( [in] LONG lEvCode );
    HRESULT RestoreDefaultHandling( [in] LONG lEvCode );
    HRESULT FreeEventParams( [in] LONG lEvCode, [in] LONG_PTR lParam1, [in] LONG_PTR lParam2 );
206 207 208 209 210 211 212 213 214 215 216 217 218
}


/*****************************************************************************
 * IMediaEventEx interface
 */
[
    object,
    uuid(56a868c0-0ad4-11ce-b03a-0020af0ba770),
    pointer_default(unique)
]
interface IMediaEventEx : IMediaEvent
{
219 220 221
    HRESULT SetNotifyWindow( [in] OAHWND hwnd, [in] LONG lMsg, [in] LONG_PTR lInstanceData );
    HRESULT SetNotifyFlags( [in] LONG lNoNotifyFlags );
    HRESULT GetNotifyFlags( [out] LONG *lplNoNotifyFlags );
222
}
223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246


/*****************************************************************************
 * IMediaPosition interface
 */
[
    object,
    uuid(56a868b2-0ad4-11ce-b03a-0020af0ba770),
    pointer_default(unique)
]
interface IMediaPosition : IDispatch
{
    HRESULT get_Duration( [out] REFTIME *plength );
    HRESULT put_CurrentPosition( [in] REFTIME llTime );
    HRESULT get_CurrentPosition( [out] REFTIME *pllTime );
    HRESULT get_StopTime( [out] REFTIME *pllTime );
    HRESULT put_StopTime( [in] REFTIME llTime );
    HRESULT get_PrerollTime( [out] REFTIME *pllTime );
    HRESULT put_PrerollTime( [in] REFTIME llTime );
    HRESULT put_Rate( [in] double dRate );
    HRESULT get_Rate( [out] double *pdRate );
    HRESULT CanSeekForward( [out] LONG *pCanSeekForward );
    HRESULT CanSeekBackward( [out] LONG *pCanSeekBackward );
}