-----------------------------------------------------------------

v 2.1 - Upgrade with support for W7 interfaces (2010-02-21)

541 Defined
304 Tested

See Interfaces.txt for the current list of tested interfaces.

Fixed 1 bug related to 64bit in DsRotEntry.

W7 introduced a number of new interfaces. Most of these had to do with digital TV,
but
there were a few that are generally useful:

http://msdn.microsoft.com/en-us/library/dd390976%28VS.85%29.aspx

These interfaces are defined in the library, but most of them are untested.

-----------------------------------------------------------------
v 2.0 - Upgrade with breaking changes (2007-07-15)

In this release, we added the new interfaces introduced into DirectShow in Vista.
Obviously
these interfaces will only work on Vista.

432 Defined
283 Tested

See Interfaces.txt for the current list of tested interfaces.

Not all of the Vista interfaces can be tested, but we have tested the ones for
which we have
hardware. The others are included as untested.

We have added the System.Security.SuppressUnmanagedCodeSecurity attribute to the

interfaces
as well. This tends to improve performance in interfaces that are called
frequently (ie many
times a second). No code change should be required.

We have also corrected problems related 64 bit support. Primarily fixing "pack"
problems on
structures, but a few interfaces have been changed to support 64 bit. Primarily
changing
parameters from int to IntPtr. This will require code changes where you are using
them, but
the changes are relatively obvious, and are easily located with a re-compile.

IMediaEventSink
IMediaEvent
IDVDInfo2
IVideoWindow
IMediaEvent
IMediaEventEx

We have also changed all the IEnumXXX interfaces so that param 3 is an IntPtr
rather than
an "out int." This is consistent with Microsoft's implementations, and absolutely
essential
for cases where someone needs to *implement* the method, rather than just call it.
The places
we have made changes are easily located with a re-compile. If you are using any of
these methods,
here's what you'll need to change:

- If you are *not* using the value returned by the 3rd parameter, simply replace
it with
IntPtr.Zero.
- If you *are* using the value returned by the 3rd parameter, you'll need
something like this:

IntPtr p = Marshal.AllocCoTaskMem(4);
try
{
hr = em.Next(monikers.Length, monikers, p);
DsError.ThrowExceptionForHR(hr);

x = Marshal.ReadInt32(p);
}
finally
{
Marshal.FreeCoTaskMem(p);
}

We have also removed a few duplicate definitions. If you were using one of these
and we deleted
the one you were using, you'll need to use the other one. The compiler will
complain about the
missing definition in your next re-compile.

AtscFilterOptions & ATSCFilterOptions

DsmccFilterOptions & DSMCCFilterOptions
MpegPacketList & MPEGPacketList
MpegRequestType & MPEGRequestType
Mpeg2Filter & MPEG2Filter
MpegWinsock & MPEGWinsock
MpegBcsDemux & BCSDeMux
MpegContext & MPEGContext
MpegStreamBuffer & MPEGStreamBuffer

We have also dropped support for VS2003. Since VS2005 has been out for 2 years now
(and is
available for free!), it doesn't seem worth the effort to put time into keeping the
vs2003 stuff
active. We haven't (to our knowledge) done anything to the library that will
prevent it from working
with 2003, but since none of the dev team still has it installed, we haven't tried
it. If you are
still using vs2003, you can check the cvs tree at sourceforge for the old .csproj
and .sln files.

And that's about it. Now that MS has stopped development on DirectShow, we may
call this library
done. Barring bug fixes, of course.

-----------------------------------------------------------------
v 1.5 - Minor upgrade (2006-08-02)
In addition to testing an additional 20 interfaces, we have also updated the
existing
definitions to enable c# code to *implement* these interfaces (instead of just
calling them).
This also fixes a fairly messy problem that could occur if you attempted to run
regasm
against the DirectShowLib.dll.

361 Defined
250 Tested
33 Deprecated & undocumented
20 Are untestable due to hw constraints (no filters implement)
27 Are untestable due to DS bugs
31 Are untestable due to various other reasons

See Interfaces.txt for the current list of tested interfaces.

v 1.4 - Minor upgrade (2006-04-12)

I didn't think we'd be doing another release quite so soon. No, it isn't because
we found
bugs. We decided to rebuild the library and samples under vs2005. We have added a
solution
and csproj file to the library and each of the samples so that you can compile them
under
either vs2003 or vs2005.

Well, all right, we found 1 bug: MPEG1WaveFormat was declared as a struct, and
should have been
a class. After nearly 12,000 downloads, this is only the 5th bug found in the
library. Not bad.

Further, we have split the samples off in to a separate download. Now that the
library is
"finished", it doesn't make sense to tie the release of samples to the release of
the library.
See the Samples package for a description of new samples.

-----------------------------------------------------------------
V 1.3 - Minor upgrade (2006-03-16)

Note: As of this release, there are no more interfaces to be tested in DirectShow

v9.0c. So,
until Microsoft releases a new version of DS (or until bugs are found in the
existing library),
no more releases of this library are planned.

However, additional samples, and "sister" libraries (DirectDraw, Windows Media

Format, etc)
are being discussed. There has also been talk of wrapping these low-level
interfaces into
classes and making a true DirectShow Class library. We'll see.

63 more interfaces tested.

359 Defined
230 Tested
38 Deprecated & undocumented
86 Others not scheduled to be tested
---
0 left to be tested (Yipee!!!!!!!)

See Interfaces.txt for the current list of tested interfaces.

3 new samples have been added.

Samples:

Samples\BDA\DVViewer
Samples\Misc\Toolkit
Samples\VMR9\VMR9Allocator2

See Docs\readme.rtf and the readme.txt in each project for details of what these
samples show.

-----------------------------------------------------------------
V 1.2 - Minor upgrade (2005-11-06)

52 more interfaces tested.

359 Defined
167 Tested
35 Deprecated & undocumented
67 Others not scheduled to be tested
---
90 left to be tested

See Interfaces.txt for the current list of tested interfaces.

4 new samples have been added.

Samples:

Samples\DMO\DMOFlip
Samples\DMO\DMOSplit
Samples\Editing\DESCombine
Samples\SBE\DvrMsCutter

See readme.rtf and the readme.txt in each project for details of what these samples
show.

-----------------------------------------------------------------
V 1.1 - Minor upgrade (2005-08-29)

54 more interfaces tested, 61 new (untested) interfaces defined including DES &
Streaming

359 Defined
114 Tested
37 Deprecated & undocumented
52 Others not scheduled to be tested
---
156 left to be tested
See Interfaces.txt for the current list of tested interfaces.

6 new samples have been added.

Samples:

Capture\CapWMV
Capture\DxPropPages
Capture\DxTuner
Players\DVDPlay
VMR9\VMR9Allocator
VMR9\BitmapMixer

See readme.rtf and the readme.txt in each project for details of what these samples
show.

Capture\DxSnap was improved to work with more hardware types.

-----------------------------------------------------------------
V 1.0 Original release (2005-07-03)

297 Interfaces defined

60 Interfaces tested

9 Samples