git.sesse.net Git - vlc/blob - modules/access/dshow/vlc_dshow.h

   1 /*****************************************************************************
   2  * vlc_dshow.h : DirectShow access module for vlc
   3  *****************************************************************************
   4  * Copyright (C) 2002, 2004, 2010-2011 VLC authors and VideoLAN
   5  * $Id$
   6  *
   7  * Author: Gildas Bazin <gbazin@videolan.org>
   8  *
   9  * This program is free software; you can redistribute it and/or modify it
  10  * under the terms of the GNU Lesser General Public License as published by
  11  * the Free Software Foundation; either version 2.1 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  17  * GNU Lesser General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU Lesser General Public License
  20  * along with this program; if not, write to the Free Software Foundation,
  21  * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  22  *****************************************************************************/
  23
  24 /*****************************************************************************
  25  * Preamble
  26  *****************************************************************************/
  27 #ifndef VLC_DSHOW_H
  28 #define VLC_DSHOW_H
  29
  30 #ifdef __MINGW32__
  31 # include <_mingw.h>
  32 #endif
  33
  34 #include <wtypes.h>
  35 #include <unknwn.h>
  36 #include <ole2.h>
  37 #include <limits.h>
  38 #include <strmif.h>
  39 #include <ksmedia.h>
  40 #include <ddraw.h>
  41
  42 #ifndef __MINGW64_VERSION_MAJOR
  43
  44 #include <dshow.h>
  45
  46 /*****************************************************************************
  47  * DirectShow GUIDs.
  48  *****************************************************************************/
  49
  50 /* IAM */
  51 DEFINE_GUID(PROPSETID_TUNER ,0x6a2e0605, 0x28e4, 0x11d0, 0xa1, 0x8c, 0x00, 0xa0, 0xc9, 0x11, 0x89, 0x56);
  52 DEFINE_GUID(IID_IAMBufferNegotiation ,0x56ed71a0, 0xaf5f, 0x11d0, 0xb3, 0xf0, 0x00, 0xaa, 0x00, 0x37, 0x61, 0xc5);
  53 DEFINE_GUID(IID_IAMTVAudio      ,0x83EC1C30, 0x23D1, 0x11d1, 0x99, 0xE6, 0x00, 0xA0, 0xC9, 0x56, 0x02, 0x66);
  54 DEFINE_GUID(IID_IAMCrossbar     ,0xC6E13380, 0x30AC, 0x11d0, 0xA1, 0x8C, 0x00, 0xA0, 0xC9, 0x11, 0x89, 0x56);
  55 DEFINE_GUID(IID_IAMTVTuner      ,0x211A8766, 0x03AC, 0x11d1, 0x8D, 0x13, 0x00, 0xAA, 0x00, 0xBD, 0x83, 0x39);
  56
  57 /* Video Format
  58 MEDIASUBTYPEs and FORMAT */
  59 DEFINE_GUID(MEDIASUBTYPE_ARGB32 ,0x773c9ac0, 0x3274, 0x11d0, 0xb7, 0x24, 0x0, 0xaa, 0x0, 0x6c, 0x1a, 0x1);
  60 /* Packed YUV formats */
  61 DEFINE_GUID(MEDIASUBTYPE_YUYV ,0x56595559, 0x0000, 0x0010, 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71);
  62 /* Planar YUV formats */
  63 DEFINE_GUID(MEDIASUBTYPE_IYUV ,0x56555949, 0x0000, 0x0010, 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71); /* identical to YV12 */
  64 DEFINE_GUID(MEDIASUBTYPE_I420 ,0x30323449, 0x0000, 0x0010, 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71);
  65 /* MPEG2 formats */
  66 DEFINE_GUID(MEDIASUBTYPE_MPEG2_VIDEO     ,0xe06d8026, 0xdb46, 0x11cf, 0xb4, 0xd1, 0x00, 0x80, 0x5f, 0x6c, 0xbb, 0xea);
  67 DEFINE_GUID(MEDIASUBTYPE_MPEG2_PROGRAM   ,0xe06d8022, 0xdb46, 0x11cf, 0xb4, 0xd1, 0x00, 0x80, 0x5f, 0x6c, 0xbb, 0xea);
  68 DEFINE_GUID(MEDIASUBTYPE_MPEG2_TRANSPORT ,0xe06d8023, 0xdb46, 0x11cf, 0xb4, 0xd1, 0x00, 0x80, 0x5f, 0x6c, 0xbb, 0xea);
  69 DEFINE_GUID(FORMAT_MPEG2Video            ,0xe06d80e3, 0xdb46, 0x11cf, 0xb4, 0xd1, 0x00, 0x80, 0x5f, 0x6c, 0xbb, 0xea);
  70
  71 /* float */
  72 DEFINE_GUID(MEDIASUBTYPE_IEEE_FLOAT ,0x00000003, 0x0000, 0x0010, 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71);
  73
  74
  75 /****************************************************************************
  76  * The following should be in ks.h and ksmedia.h, but since they are not in
  77  * the current version of Mingw, we will be defined here.
  78  ****************************************************************************/
  79
  80 /* http://msdn.microsoft.com/en-us/library/ff567297%28VS.85%29.aspx */
  81 typedef enum  {
  82         KS_AnalogVideo_None          = 0x00000000,
  83         KS_AnalogVideo_NTSC_M        = 0x00000001,
  84         KS_AnalogVideo_NTSC_M_J      = 0x00000002,
  85         KS_AnalogVideo_NTSC_433      = 0x00000004,
  86         KS_AnalogVideo_PAL_B         = 0x00000010,
  87         KS_AnalogVideo_PAL_D         = 0x00000020,
  88         KS_AnalogVideo_PAL_G         = 0x00000040,
  89         KS_AnalogVideo_PAL_H         = 0x00000080,
  90         KS_AnalogVideo_PAL_I         = 0x00000100,
  91         KS_AnalogVideo_PAL_M         = 0x00000200,
  92         KS_AnalogVideo_PAL_N         = 0x00000400,
  93         KS_AnalogVideo_PAL_60        = 0x00000800,
  94         KS_AnalogVideo_SECAM_B       = 0x00001000,
  95         KS_AnalogVideo_SECAM_D       = 0x00002000,
  96         KS_AnalogVideo_SECAM_G       = 0x00004000,
  97         KS_AnalogVideo_SECAM_H       = 0x00008000,
  98         KS_AnalogVideo_SECAM_K       = 0x00010000,
  99         KS_AnalogVideo_SECAM_K1      = 0x00020000,
 100         KS_AnalogVideo_SECAM_L       = 0x00040000,
 101         KS_AnalogVideo_SECAM_L1      = 0x00080000,
 102         KS_AnalogVideo_PAL_N_COMBO   = 0x00100000
 103 } KS_AnalogVideoStandard;
 104
 105 /* http://msdn.microsoft.com/en-us/library/ff567800%28VS.85%29.aspx and following */
 106 typedef enum {
 107     KSPROPERTY_TUNER_CAPS,              // R  -overall device capabilities
 108     KSPROPERTY_TUNER_MODE_CAPS,         // R  -capabilities in this mode
 109     KSPROPERTY_TUNER_MODE,              // RW -set a mode (TV, FM, AM, DSS)
 110     KSPROPERTY_TUNER_STANDARD,          // R  -get TV standard (only if TV mode)
 111     KSPROPERTY_TUNER_FREQUENCY,         // RW -set/get frequency
 112     KSPROPERTY_TUNER_INPUT,             // RW -select an input
 113     KSPROPERTY_TUNER_STATUS,            // R  -tuning status
 114
 115     /* Optional */
 116     KSPROPERTY_TUNER_IF_MEDIUM,         // R O-Medium for IF or Transport Pin
 117
 118     /* Mandatory for Vista and + */
 119     KSPROPERTY_TUNER_SCAN_CAPS,         // R  -overall device capabilities for scanning
 120
 121     /* Optional ones */
 122     KSPROPERTY_TUNER_SCAN_STATUS,       // R  -status of scan
 123     KSPROPERTY_TUNER_STANDARD_MODE,     // RW -autodetect mode for signal standard
 124     KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS // R -network type specific tuner capabilities
 125 } KSPROPERTY_TUNER;
 126
 127 /* http://msdn.microsoft.com/en-us/library/ff567689%28v=VS.85%29.aspx */
 128 typedef enum {
 129     KS_TUNER_TUNING_EXACT = 1,        // Tunes directly to the right freq
 130     KS_TUNER_TUNING_FINE,             // Comprehensive search to the right freq
 131     KS_TUNER_TUNING_COARSE,           // Fast search
 132 }KS_TUNER_TUNING_FLAGS;
 133
 134 /* http://msdn.microsoft.com/en-us/library/ff567687%28v=VS.85%29.aspx */
 135 typedef enum {
 136     KS_TUNER_STRATEGY_PLL             = 0X01, // Phase locked loop (PLL) offset tuning
 137     KS_TUNER_STRATEGY_SIGNAL_STRENGTH = 0X02, // Signal strength tuning
 138     KS_TUNER_STRATEGY_DRIVER_TUNES    = 0X04, // Driver tunes
 139 }KS_TUNER_STRATEGY;
 140
 141 /* http://msdn.microsoft.com/en-us/library/ff562676%28VS.85%29.aspx */
 142 typedef struct {
 143     union {
 144         struct {
 145             GUID    Set;
 146             ULONG   Id;
 147             ULONG   Flags;
 148         };
 149         LONGLONG    Alignment;
 150     };
 151 } KSIDENTIFIER, *PKSIDENTIFIER;
 152
 153 typedef KSIDENTIFIER KSPROPERTY, *PKSPROPERTY;
 154
 155 /* http://msdn.microsoft.com/en-us/library/ff565872%28v=VS.85%29.aspx */
 156 typedef struct {
 157     KSPROPERTY Property;
 158     ULONG  Mode;                        // KSPROPERTY_TUNER_MODE_*
 159     ULONG  StandardsSupported;          // KS_AnalogVideo_* (if Mode is TV or DSS)
 160     ULONG  MinFrequency;                // Hz
 161     ULONG  MaxFrequency;                // Hz
 162     ULONG  TuningGranularity;           // Hz
 163     ULONG  NumberOfInputs;              // number of inputs
 164     ULONG  SettlingTime;                // milliSeconds
 165     ULONG  Strategy;                    // KS_TUNER_STRATEGY
 166 } KSPROPERTY_TUNER_MODE_CAPS_S, *PKSPROPERTY_TUNER_MODE_CAPS_S;
 167
 168 /* http://msdn.microsoft.com/en-us/library/ff565839%28v=VS.85%29.aspx */
 169 typedef struct {
 170     KSPROPERTY Property;
 171     ULONG  Frequency;                   // Hz
 172     ULONG  LastFrequency;               // Hz (last tuned)
 173     ULONG  TuningFlags;                 // KS_TUNER_TUNING_FLAGS
 174     ULONG  VideoSubChannel;             // DSS
 175     ULONG  AudioSubChannel;             // DSS
 176     ULONG  Channel;                     // VBI decoders
 177     ULONG  Country;                     // VBI decoders
 178 } KSPROPERTY_TUNER_FREQUENCY_S, *PKSPROPERTY_TUNER_FREQUENCY_S;
 179
 180 /* http://msdn.microsoft.com/en-us/library/ff565918%28v=VS.85%29.aspx */
 181 typedef struct {
 182     KSPROPERTY Property;
 183     ULONG  Standard;                    // KS_AnalogVideo_*
 184 } KSPROPERTY_TUNER_STANDARD_S, *PKSPROPERTY_TUNER_STANDARD_S;
 185 /* End of ks */
 186
 187
 188 /* Define missing interfaces from wine's header */
 189 /* http://msdn.microsoft.com/en-us/library/dd373441%28v=vs.85%29.aspx */
 190 typedef enum tagAMTunerModeType {
 191     AMTUNER_MODE_DEFAULT    = 0x0000,
 192     AMTUNER_MODE_TV         = 0x0001,
 193     AMTUNER_MODE_FM_RADIO   = 0x0002,
 194     AMTUNER_MODE_AM_RADIO   = 0x0004,
 195     AMTUNER_MODE_DSS        = 0x0008
 196 } AMTunerModeType;
 197
 198 #define AMPROPERTY_PIN_CATEGORY 0
 199 typedef enum tagAMTunerSubChannel {
 200     AMTUNER_SUBCHAN_NO_TUNE = -2,
 201     AMTUNER_SUBCHAN_DEFAULT = -1
 202 } AMTunerSubChannel;
 203
 204 /* http://msdn.microsoft.com/en-us/library/dd407232%28v=vs.85%29.aspx */
 205 typedef enum tagTunerInputType {
 206     TunerInputCable = 0,
 207     TunerInputAntenna = TunerInputCable + 1
 208 } TunerInputType;
 209
 210 typedef enum tagAMTunerEventType {
 211     AMTUNER_EVENT_CHANGED = 0x1
 212 } AMTunerEventType;
 213
 214 /* http://msdn.microsoft.com/en-us/library/dd377421%28v=vs.85%29.aspx */
 215 typedef enum tagPhysicalConnectorType {
 216     PhysConn_Video_Tuner             = 1,
 217     PhysConn_Video_Composite,
 218     PhysConn_Video_SVideo,
 219     PhysConn_Video_RGB,
 220     PhysConn_Video_YRYBY,
 221     PhysConn_Video_SerialDigital,
 222     PhysConn_Video_ParallelDigital,
 223     PhysConn_Video_SCSI,
 224     PhysConn_Video_AUX,
 225     PhysConn_Video_1394,
 226     PhysConn_Video_USB,
 227     PhysConn_Video_VideoDecoder,
 228     PhysConn_Video_VideoEncoder,
 229     PhysConn_Video_SCART,
 230     PhysConn_Video_Black,
 231     PhysConn_Audio_Tuner             = 4096, /* 0x1000 */
 232     PhysConn_Audio_Line,
 233     PhysConn_Audio_Mic,
 234     PhysConn_Audio_AESDigital,
 235     PhysConn_Audio_SPDIFDigital,
 236     PhysConn_Audio_SCSI,
 237     PhysConn_Audio_AUX,
 238     PhysConn_Audio_1394,
 239     PhysConn_Audio_USB,
 240     PhysConn_Audio_AudioDecoder
 241 } PhysicalConnectorType;
 242
 243 /* http://msdn.microsoft.com/en-us/library/dd407352%28v=vs.85%29.aspx */
 244 typedef struct _VIDEO_STREAM_CONFIG_CAPS {
 245     GUID     guid;
 246     ULONG    VideoStandard;
 247     SIZE     InputSize;
 248     SIZE     MinCroppingSize;
 249     SIZE     MaxCroppingSize;
 250     int      CropGranularityX;
 251     int      CropGranularityY;
 252     int      CropAlignX;
 253     int      CropAlignY;
 254     SIZE     MinOutputSize;
 255     SIZE     MaxOutputSize;
 256     int      OutputGranularityX;
 257     int      OutputGranularityY;
 258     int      StretchTapsX;
 259     int      StretchTapsY;
 260     int      ShrinkTapsX;
 261     int      ShrinkTapsY;
 262     LONGLONG MinFrameInterval;
 263     LONGLONG MaxFrameInterval;
 264     LONG     MinBitsPerSecond;
 265     LONG     MaxBitsPerSecond;
 266 } VIDEO_STREAM_CONFIG_CAPS;
 267
 268 /* http://msdn.microsoft.com/en-us/library/dd317597%28v=vs.85%29.aspx */
 269 typedef struct _AUDIO_STREAM_CONFIG_CAPS {
 270     GUID  guid;
 271     ULONG MinimumChannels;
 272     ULONG MaximumChannels;
 273     ULONG ChannelsGranularity;
 274     ULONG MinimumBitsPerSample;
 275     ULONG MaximumBitsPerSample;
 276     ULONG BitsPerSampleGranularity;
 277     ULONG MinimumSampleFrequency;
 278     ULONG MaximumSampleFrequency;
 279     ULONG SampleFrequencyGranularity;
 280 } AUDIO_STREAM_CONFIG_CAPS;
 281
 282 /* http://msdn.microsoft.com/en-us/library/dd389142%28v=vs.85%29.aspx */
 283 #undef INTERFACE
 284 #define INTERFACE IAMBufferNegotiation
 285 DECLARE_INTERFACE_(IAMBufferNegotiation, IUnknown)
 286 {
 287     STDMETHOD(QueryInterface) (THIS_ REFIID, PVOID*) PURE;
 288     STDMETHOD_(ULONG,AddRef )(THIS);
 289     STDMETHOD_(ULONG,Release )(THIS);
 290     STDMETHOD(SuggestAllocatorProperties )(THIS_ const ALLOCATOR_PROPERTIES *);
 291     STDMETHOD(GetAllocatorProperties )(THIS_ ALLOCATOR_PROPERTIES *);
 292 };
 293
 294 /* http://msdn.microsoft.com/en-us/library/dd389171%28v=vs.85%29.aspx */
 295 #undef INTERFACE
 296 #define INTERFACE IAMCrossbar
 297 DECLARE_INTERFACE_(IAMCrossbar, IUnknown)
 298 {
 299     STDMETHOD(QueryInterface) (THIS_ REFIID, PVOID*) PURE;
 300     STDMETHOD_(ULONG, AddRef) (THIS);
 301     STDMETHOD_(ULONG, Release) (THIS);
 302     STDMETHOD(get_PinCounts) (THIS_ long *, long *);
 303     STDMETHOD(CanRoute) (THIS_ long, long);
 304     STDMETHOD(Route) (THIS_ long, long);
 305     STDMETHOD(get_IsRoutedTo) (THIS_ long, long *);
 306     STDMETHOD(get_CrossbarPinInfo) (THIS_ BOOL, long, long *, long *);
 307 };
 308
 309 /* http://msdn.microsoft.com/en-us/library/dd375945%28v=vs.85%29.aspx */
 310 #undef INTERFACE
 311 #define INTERFACE IAMTunerNotification
 312 DECLARE_INTERFACE_( IAMTunerNotification, IUnknown)
 313 {
 314     STDMETHOD(QueryInterface) (THIS_ REFIID, PVOID*) PURE;
 315     STDMETHOD_(ULONG, AddRef) (THIS);
 316     STDMETHOD_(ULONG, Release) (THIS);
 317     STDMETHOD(OnEvent) (THIS_ AMTunerEventType);
 318 };
 319
 320 /* http://msdn.microsoft.com/en-us/library/dd375971%28v=vs.85%29.aspx */
 321 #undef INTERFACE
 322 #define INTERFACE IAMTVTuner
 323 DECLARE_INTERFACE_(IAMTVTuner, IUnknown)
 324 {
 325     STDMETHOD(QueryInterface) (THIS_ REFIID, PVOID*) PURE;
 326     STDMETHOD_(ULONG, AddRef) (THIS);
 327     STDMETHOD_(ULONG, Release) (THIS);
 328     STDMETHOD(put_Channel) (THIS_ long, long, long);
 329     STDMETHOD(get_Channel) (THIS_ long *, long *, long *);
 330     STDMETHOD(ChannelMinMax) (THIS_ long *, long *);
 331     STDMETHOD(put_CountryCode) (THIS_ long);
 332     STDMETHOD(get_CountryCode) (THIS_ long *);
 333     STDMETHOD(put_TuningSpace) (THIS_ long);
 334     STDMETHOD(get_TuningSpace) (THIS_ long *);
 335     STDMETHOD(Logon) (THIS_ HANDLE);
 336     STDMETHOD(Logout) (IAMTVTuner *);
 337     STDMETHOD(SignalPresen) (THIS_ long *);
 338     STDMETHOD(put_Mode) (THIS_ AMTunerModeType);
 339     STDMETHOD(get_Mode) (THIS_ AMTunerModeType *);
 340     STDMETHOD(GetAvailableModes) (THIS_ long *);
 341     STDMETHOD(RegisterNotificationCallBack) (THIS_ IAMTunerNotification *, long);
 342     STDMETHOD(UnRegisterNotificationCallBack) (THIS_ IAMTunerNotification *);
 343     STDMETHOD(get_AvailableTVFormats) (THIS_ long *);
 344     STDMETHOD(get_TVFormat) (THIS_ long *);
 345     STDMETHOD(AutoTune) (THIS_ long, long *);
 346     STDMETHOD(StoreAutoTune) (IAMTVTuner *);
 347     STDMETHOD(get_NumInputConnections) (THIS_ long *);
 348     STDMETHOD(put_InputType) (THIS_ long, TunerInputType);
 349     STDMETHOD(get_InputType) (THIS_ long, TunerInputType *);
 350     STDMETHOD(put_ConnectInput) (THIS_ long);
 351     STDMETHOD(get_ConnectInput) (THIS_ long *);
 352     STDMETHOD(get_VideoFrequency) (THIS_ long *);
 353     STDMETHOD(get_AudioFrequency) (THIS_ long *);
 354 };
 355
 356 /* http://msdn.microsoft.com/en-us/library/dd375962%28v=vs.85%29.aspx */
 357 #undef INTERFACE
 358 #define INTERFACE IAMTVAudio
 359 DECLARE_INTERFACE_(IAMTVAudio, IUnknown)
 360 {
 361     STDMETHOD(QueryInterface) (THIS_ REFIID, PVOID*) PURE;
 362     STDMETHOD_(ULONG, AddRef) (THIS);
 363     STDMETHOD_(ULONG, Release) (THIS);
 364     STDMETHOD(GetHardwareSupportedTVAudioModes) (THIS_ long *);
 365     STDMETHOD(GetAvailableTVAudioModes) (THIS_ long *);
 366     STDMETHOD(get_TVAudioMode) (THIS_ long *);
 367     STDMETHOD(put_TVAudioMode) (THIS_ long);
 368     STDMETHOD(RegisterNotificationCallBack) (THIS_ IAMTunerNotification*, long);
 369     STDMETHOD(UnRegisterNotificationCallBack) (THIS_ IAMTunerNotification*);
 370 };
 371
 372 #endif /* __MINGW64_VERSION_MAJOR */
 373 #endif /* VLC_DSHOW_H */