What is DirectShow.NET?
DirectShow.NET is a library for manage code (.NET framework) that allows developers access (preview/capture) video devices (webcams, TV-tunnels, scanners etc.) by using simple objects like enums, structs and interfaces. Developers don’t have to worry about filters, memory addresses, and GUIDs as C++ and COM developers do all these things manually.
Filters filters = new Filters();
“Filters” class do following jobs:
- Track all video devices attached to your PC
- Track all audio devices attached to your PC
- Track all video compressors
- Track all audio compressors
To access first video device (webcam) and first audio device connected to your PC:
Capture capture = new Capture(
By setting “PreviewWindow” property; you can preview the captured video into a panel or in any container windows forms control:
capture.PreviewWindow = panel;
In the above line, “panel” is System.Windows.Forms.Panel object.
And your last task is start previewing the video stream!
To save the captured video into the Disk device; you’ve to set “FileName” property:
if (!capture.Cued) capture.Filename = "captured-video.wmv";
For tracking second or third video or audio device connected to your PC, just increment the index:
Capturecapture = new Capture(
It is better to use first audio device (index: 0) if all webcams are placed in the same room.
In case, when there is no video device attached to your PC, the program will throw an error. I recommend you use this technique instead of using try-catch blocks to handle the error:
if (filters.VideoInputDevices != null)
// all code goes here
To stop streaming (previewing or capturing into disk):
To capture as quickly as possible, use “capture.Cue()” method:
This will speedup streaming/capturing into disk.
In the demo project, I’m not only previewing and capturing into disk but also using timer to automatically change file name after each 10 minutes.
I’m using timer because the size of video file goes into GB after some time; so we’ve to split video files for FTP upload or other uses!
timer.Interval = 600000; // 10 minutes!
In the “Tick” event of the “timer” object:
if (!capture.Cued) capture.Filename = counter + ".wmv";
Where I’m incrementing “counter” object on each tick.
I’m capturing video into “WMV” file; you can also use “AVI” or other supported formats.
DirectShow supports ASF, WMA, WMV, AIFF, AU, AVI, MIDI, SND, and WAV video formats.
You can also compress the video:
capture.VideoCompressor = filters.VideoCompressors;
capture.AudioCompressor = filters.AudioCompressors;
DirectShow supports compression formats such as H.264, AAC, Cinepak, DV (Digital Video), ISO MPEG-4 video version 1.0, Microsoft MPEG-4 version 3, MJPEG, MPEG Audio Layer-3 (MP3) (decompression only), MPEG-1 layer I and layer II audio, MPEG-1 video, MPEG-2 audio, and MPEG-2 video.You can also use third party codecs.
- Download DirectShow.NET Library
- Download Demo
- Download Source Code of the Demo Project
- Origianl Source code of DirectShow.NET Library edited by Muaz Khan
Updated at March 1, 2013:
You can set width and height of the “panel” element to control frame size (i.e. min/max width/height) of the preview screen:
panel.Width = this.Width;
panel.Height = this.Height;
Above two lines will set panel’s width and height equal to current window’s width and height.