dshow: add options for allowing filter popup configuration dialogs to be presented...
[ffmpeg.git] / libavdevice / dshow_capture.h
1 /*
2  * DirectShow capture interface
3  * Copyright (c) 2010 Ramiro Polla
4  *
5  * This file is part of FFmpeg.
6  *
7  * FFmpeg is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Lesser General Public
9  * License as published by the Free Software Foundation; either
10  * version 2.1 of the License, or (at your option) any later version.
11  *
12  * FFmpeg is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15  * Lesser General Public License for more details.
16  *
17  * You should have received a copy of the GNU Lesser General Public
18  * License along with FFmpeg; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20  */
21
22 #ifndef AVDEVICE_DSHOW_H
23 #define AVDEVICE_DSHOW_H
24
25 #define DSHOWDEBUG 0
26
27 #include "avdevice.h"
28
29 #define COBJMACROS
30 #define WIN32_LEAN_AND_MEAN
31 #include <windows.h>
32 #define NO_DSHOW_STRSAFE
33 #include <dshow.h>
34 #include <dvdmedia.h>
35
36 /* EC_DEVICE_LOST is not defined in MinGW dshow headers. */
37 #ifndef EC_DEVICE_LOST
38 #define EC_DEVICE_LOST 0x1f
39 #endif
40
41 long ff_copy_dshow_media_type(AM_MEDIA_TYPE *dst, const AM_MEDIA_TYPE *src);
42 void ff_print_VIDEO_STREAM_CONFIG_CAPS(const VIDEO_STREAM_CONFIG_CAPS *caps);
43 void ff_print_AUDIO_STREAM_CONFIG_CAPS(const AUDIO_STREAM_CONFIG_CAPS *caps);
44 void ff_print_AM_MEDIA_TYPE(const AM_MEDIA_TYPE *type);
45 void ff_printGUID(const GUID *g);
46
47 #if DSHOWDEBUG
48 extern const AVClass *ff_dshow_context_class_ptr;
49 #define dshowdebug(...) av_log(&ff_dshow_context_class_ptr, AV_LOG_DEBUG, __VA_ARGS__)
50 #else
51 #define dshowdebug(...)
52 #endif
53
54 static inline void nothing(void *foo)
55 {
56 }
57
58 struct GUIDoffset {
59     const GUID *iid;
60     int offset;
61 };
62
63 enum dshowDeviceType {
64     VideoDevice = 0,
65     AudioDevice = 1,
66 };
67
68 #define DECLARE_QUERYINTERFACE(class, ...)                                   \
69 long WINAPI                                                                  \
70 class##_QueryInterface(class *this, const GUID *riid, void **ppvObject)      \
71 {                                                                            \
72     struct GUIDoffset ifaces[] = __VA_ARGS__;                                \
73     int i;                                                                   \
74     dshowdebug(AV_STRINGIFY(class)"_QueryInterface(%p, %p, %p)\n", this, riid, ppvObject); \
75     ff_printGUID(riid);                                                      \
76     if (!ppvObject)                                                          \
77         return E_POINTER;                                                    \
78     for (i = 0; i < sizeof(ifaces)/sizeof(ifaces[0]); i++) {                 \
79         if (IsEqualGUID(riid, ifaces[i].iid)) {                              \
80             void *obj = (void *) ((uint8_t *) this + ifaces[i].offset);      \
81             class##_AddRef(this);                                            \
82             dshowdebug("\tfound %d with offset %d\n", i, ifaces[i].offset);  \
83             *ppvObject = (void *) obj;                                       \
84             return S_OK;                                                     \
85         }                                                                    \
86     }                                                                        \
87     dshowdebug("\tE_NOINTERFACE\n");                                         \
88     *ppvObject = NULL;                                                       \
89     return E_NOINTERFACE;                                                    \
90 }
91 #define DECLARE_ADDREF(class)                                                \
92 unsigned long WINAPI                                                         \
93 class##_AddRef(class *this)                                                  \
94 {                                                                            \
95     dshowdebug(AV_STRINGIFY(class)"_AddRef(%p)\t%ld\n", this, this->ref+1);  \
96     return InterlockedIncrement(&this->ref);                                 \
97 }
98 #define DECLARE_RELEASE(class)                                               \
99 unsigned long WINAPI                                                         \
100 class##_Release(class *this)                                                 \
101 {                                                                            \
102     long ref = InterlockedDecrement(&this->ref);                             \
103     dshowdebug(AV_STRINGIFY(class)"_Release(%p)\t%ld\n", this, ref);         \
104     if (!ref)                                                                \
105         class##_Destroy(this);                                               \
106     return ref;                                                              \
107 }
108
109 #define DECLARE_DESTROY(class, func)                                         \
110 void class##_Destroy(class *this)                                            \
111 {                                                                            \
112     dshowdebug(AV_STRINGIFY(class)"_Destroy(%p)\n", this);                   \
113     func(this);                                                              \
114     if (this) {                                                              \
115         if (this->vtbl)                                                      \
116             CoTaskMemFree(this->vtbl);                                       \
117         CoTaskMemFree(this);                                                 \
118     }                                                                        \
119 }
120 #define DECLARE_CREATE(class, setup, ...)                                    \
121 class *class##_Create(__VA_ARGS__)                                           \
122 {                                                                            \
123     class *this = CoTaskMemAlloc(sizeof(class));                             \
124     void  *vtbl = CoTaskMemAlloc(sizeof(*this->vtbl));                       \
125     dshowdebug(AV_STRINGIFY(class)"_Create(%p)\n", this);                    \
126     if (!this || !vtbl)                                                      \
127         goto fail;                                                           \
128     ZeroMemory(this, sizeof(class));                                         \
129     ZeroMemory(vtbl, sizeof(*this->vtbl));                                   \
130     this->ref  = 1;                                                          \
131     this->vtbl = vtbl;                                                       \
132     if (!setup)                                                              \
133         goto fail;                                                           \
134     dshowdebug("created "AV_STRINGIFY(class)" %p\n", this);                  \
135     return this;                                                             \
136 fail:                                                                        \
137     class##_Destroy(this);                                                   \
138     dshowdebug("could not create "AV_STRINGIFY(class)"\n");                  \
139     return NULL;                                                             \
140 }
141
142 #define SETVTBL(vtbl, class, fn) \
143     do { (vtbl)->fn = (void *) class##_##fn; } while(0)
144
145 /*****************************************************************************
146  * Forward Declarations
147  ****************************************************************************/
148 typedef struct libAVPin libAVPin;
149 typedef struct libAVMemInputPin libAVMemInputPin;
150 typedef struct libAVEnumPins libAVEnumPins;
151 typedef struct libAVEnumMediaTypes libAVEnumMediaTypes;
152 typedef struct libAVFilter libAVFilter;
153
154 /*****************************************************************************
155  * libAVPin
156  ****************************************************************************/
157 struct libAVPin {
158     IPinVtbl *vtbl;
159     long ref;
160     libAVFilter *filter;
161     IPin *connectedto;
162     AM_MEDIA_TYPE type;
163     IMemInputPinVtbl *imemvtbl;
164 };
165
166 long          WINAPI libAVPin_QueryInterface          (libAVPin *, const GUID *, void **);
167 unsigned long WINAPI libAVPin_AddRef                  (libAVPin *);
168 unsigned long WINAPI libAVPin_Release                 (libAVPin *);
169 long          WINAPI libAVPin_Connect                 (libAVPin *, IPin *, const AM_MEDIA_TYPE *);
170 long          WINAPI libAVPin_ReceiveConnection       (libAVPin *, IPin *, const AM_MEDIA_TYPE *);
171 long          WINAPI libAVPin_Disconnect              (libAVPin *);
172 long          WINAPI libAVPin_ConnectedTo             (libAVPin *, IPin **);
173 long          WINAPI libAVPin_ConnectionMediaType     (libAVPin *, AM_MEDIA_TYPE *);
174 long          WINAPI libAVPin_QueryPinInfo            (libAVPin *, PIN_INFO *);
175 long          WINAPI libAVPin_QueryDirection          (libAVPin *, PIN_DIRECTION *);
176 long          WINAPI libAVPin_QueryId                 (libAVPin *, wchar_t **);
177 long          WINAPI libAVPin_QueryAccept             (libAVPin *, const AM_MEDIA_TYPE *);
178 long          WINAPI libAVPin_EnumMediaTypes          (libAVPin *, IEnumMediaTypes **);
179 long          WINAPI libAVPin_QueryInternalConnections(libAVPin *, IPin **, unsigned long *);
180 long          WINAPI libAVPin_EndOfStream             (libAVPin *);
181 long          WINAPI libAVPin_BeginFlush              (libAVPin *);
182 long          WINAPI libAVPin_EndFlush                (libAVPin *);
183 long          WINAPI libAVPin_NewSegment              (libAVPin *, REFERENCE_TIME, REFERENCE_TIME, double);
184
185 long          WINAPI libAVMemInputPin_QueryInterface          (libAVMemInputPin *, const GUID *, void **);
186 unsigned long WINAPI libAVMemInputPin_AddRef                  (libAVMemInputPin *);
187 unsigned long WINAPI libAVMemInputPin_Release                 (libAVMemInputPin *);
188 long          WINAPI libAVMemInputPin_GetAllocator            (libAVMemInputPin *, IMemAllocator **);
189 long          WINAPI libAVMemInputPin_NotifyAllocator         (libAVMemInputPin *, IMemAllocator *, BOOL);
190 long          WINAPI libAVMemInputPin_GetAllocatorRequirements(libAVMemInputPin *, ALLOCATOR_PROPERTIES *);
191 long          WINAPI libAVMemInputPin_Receive                 (libAVMemInputPin *, IMediaSample *);
192 long          WINAPI libAVMemInputPin_ReceiveMultiple         (libAVMemInputPin *, IMediaSample **, long, long *);
193 long          WINAPI libAVMemInputPin_ReceiveCanBlock         (libAVMemInputPin *);
194
195 void                 libAVPin_Destroy(libAVPin *);
196 libAVPin            *libAVPin_Create (libAVFilter *filter);
197
198 void                 libAVMemInputPin_Destroy(libAVMemInputPin *);
199
200 /*****************************************************************************
201  * libAVEnumPins
202  ****************************************************************************/
203 struct libAVEnumPins {
204     IEnumPinsVtbl *vtbl;
205     long ref;
206     int pos;
207     libAVPin *pin;
208     libAVFilter *filter;
209 };
210
211 long          WINAPI libAVEnumPins_QueryInterface(libAVEnumPins *, const GUID *, void **);
212 unsigned long WINAPI libAVEnumPins_AddRef        (libAVEnumPins *);
213 unsigned long WINAPI libAVEnumPins_Release       (libAVEnumPins *);
214 long          WINAPI libAVEnumPins_Next          (libAVEnumPins *, unsigned long, IPin **, unsigned long *);
215 long          WINAPI libAVEnumPins_Skip          (libAVEnumPins *, unsigned long);
216 long          WINAPI libAVEnumPins_Reset         (libAVEnumPins *);
217 long          WINAPI libAVEnumPins_Clone         (libAVEnumPins *, libAVEnumPins **);
218
219 void                 libAVEnumPins_Destroy(libAVEnumPins *);
220 libAVEnumPins       *libAVEnumPins_Create (libAVPin *pin, libAVFilter *filter);
221
222 /*****************************************************************************
223  * libAVEnumMediaTypes
224  ****************************************************************************/
225 struct libAVEnumMediaTypes {
226     IEnumMediaTypesVtbl *vtbl;
227     long ref;
228     int pos;
229     AM_MEDIA_TYPE type;
230 };
231
232 long          WINAPI libAVEnumMediaTypes_QueryInterface(libAVEnumMediaTypes *, const GUID *, void **);
233 unsigned long WINAPI libAVEnumMediaTypes_AddRef        (libAVEnumMediaTypes *);
234 unsigned long WINAPI libAVEnumMediaTypes_Release       (libAVEnumMediaTypes *);
235 long          WINAPI libAVEnumMediaTypes_Next          (libAVEnumMediaTypes *, unsigned long, AM_MEDIA_TYPE **, unsigned long *);
236 long          WINAPI libAVEnumMediaTypes_Skip          (libAVEnumMediaTypes *, unsigned long);
237 long          WINAPI libAVEnumMediaTypes_Reset         (libAVEnumMediaTypes *);
238 long          WINAPI libAVEnumMediaTypes_Clone         (libAVEnumMediaTypes *, libAVEnumMediaTypes **);
239
240 void                 libAVEnumMediaTypes_Destroy(libAVEnumMediaTypes *);
241 libAVEnumMediaTypes *libAVEnumMediaTypes_Create(const AM_MEDIA_TYPE *type);
242
243 /*****************************************************************************
244  * libAVFilter
245  ****************************************************************************/
246 struct libAVFilter {
247     IBaseFilterVtbl *vtbl;
248     long ref;
249     const wchar_t *name;
250     libAVPin *pin;
251     FILTER_INFO info;
252     FILTER_STATE state;
253     IReferenceClock *clock;
254     enum dshowDeviceType type;
255     void *priv_data;
256     int stream_index;
257     int64_t start_time;
258     void (*callback)(void *priv_data, int index, uint8_t *buf, int buf_size, int64_t time, enum dshowDeviceType type);
259 };
260
261 long          WINAPI libAVFilter_QueryInterface (libAVFilter *, const GUID *, void **);
262 unsigned long WINAPI libAVFilter_AddRef         (libAVFilter *);
263 unsigned long WINAPI libAVFilter_Release        (libAVFilter *);
264 long          WINAPI libAVFilter_GetClassID     (libAVFilter *, CLSID *);
265 long          WINAPI libAVFilter_Stop           (libAVFilter *);
266 long          WINAPI libAVFilter_Pause          (libAVFilter *);
267 long          WINAPI libAVFilter_Run            (libAVFilter *, REFERENCE_TIME);
268 long          WINAPI libAVFilter_GetState       (libAVFilter *, DWORD, FILTER_STATE *);
269 long          WINAPI libAVFilter_SetSyncSource  (libAVFilter *, IReferenceClock *);
270 long          WINAPI libAVFilter_GetSyncSource  (libAVFilter *, IReferenceClock **);
271 long          WINAPI libAVFilter_EnumPins       (libAVFilter *, IEnumPins **);
272 long          WINAPI libAVFilter_FindPin        (libAVFilter *, const wchar_t *, IPin **);
273 long          WINAPI libAVFilter_QueryFilterInfo(libAVFilter *, FILTER_INFO *);
274 long          WINAPI libAVFilter_JoinFilterGraph(libAVFilter *, IFilterGraph *, const wchar_t *);
275 long          WINAPI libAVFilter_QueryVendorInfo(libAVFilter *, wchar_t **);
276
277 void                 libAVFilter_Destroy(libAVFilter *);
278 libAVFilter         *libAVFilter_Create (void *, void *, enum dshowDeviceType);
279
280 /*****************************************************************************
281  * dshow_ctx
282  ****************************************************************************/
283 struct dshow_ctx {
284     const AVClass *class;
285
286     IGraphBuilder *graph;
287
288     char *device_name[2];
289     int video_device_number;
290     int audio_device_number;
291
292     int   list_options;
293     int   list_devices;
294     int   audio_buffer_size;
295     int   crossbar_video_input_pin_number;
296     int   crossbar_audio_input_pin_number;
297     char *video_pin_name;
298     char *audio_pin_name;
299     int   show_video_device_dialog;
300     int   show_audio_device_dialog;
301     int   show_crossbar_connection_dialog;
302
303     IBaseFilter *device_filter[2];
304     IPin        *device_pin[2];
305     libAVFilter *capture_filter[2];
306     libAVPin    *capture_pin[2];
307
308     HANDLE mutex;
309     HANDLE event[2]; /* event[0] is set by DirectShow
310                       * event[1] is set by callback() */
311     AVPacketList *pktl;
312
313     int eof;
314
315     int64_t curbufsize[2];
316     unsigned int video_frame_num;
317
318     IMediaControl *control;
319     IMediaEvent *media_event;
320
321     enum AVPixelFormat pixel_format;
322     enum AVCodecID video_codec_id;
323     char *framerate;
324
325     int requested_width;
326     int requested_height;
327     AVRational requested_framerate;
328
329     int sample_rate;
330     int sample_size;
331     int channels;
332 };
333
334 /*****************************************************************************
335  * CrossBar
336  ****************************************************************************/
337 HRESULT dshow_try_setup_crossbar_options(ICaptureGraphBuilder2 *graph_builder2,
338     IBaseFilter *device_filter, enum dshowDeviceType devtype, AVFormatContext *avctx);
339
340 void dshow_show_filter_properties(IBaseFilter *pFilter, AVFormatContext *avctx);
341
342 #endif /* AVDEVICE_DSHOW_H */