DirectShow Readme

Welcome to the DirectShow SDK

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.

This document provides late-breaking or other information that supplements the Microsoft DirectShow documentation.

Overview

New Since ActiveMovie 1.0

Building the Samples

Known Issues and Troubleshooting

Documentation Additions

Contact Information

Capture Hardware Tested with this Release

### Overview

To get started with the DirectShow SDK, please do the following:

Read Getting Started section of the Microsoft DirectShow SDK documentation.

Read the NEW SINCE ACTIVEMOVIE 1.0 section of this Readme.

Read the license information.

Licensing information is located in the license.doc in the root of the CD, and eula.doc in the x86\redist and alpha\redist directories.

DirectShow will fully replace MCI functionality over time, but that functionality is not completely implemented yet. In addition, Visual Basic support for some properties of the ActiveMovie control is not yet complete, which might result in some restricted functionality. A detailed list of the known limitations can be found in Microsoft's on-line Knowledge Base (http://www.microsoft.com/kb), searching the Win32 SDK database for article number Q157060.

Some of these issues are being addressed with the 5.2 release and the DirectShow team welcomes any feedback regarding bugs or restrictions so that problems can be rectified as soon as possible. Please direct your feedback via e-mail to dxmbeta@microsoft.com.

For the latest on DirectShow, check out Microsoft's on-line Knowledge Base (http://www.microsoft.com/kb). Search the Win32 SDK product for keywords such as ActiveMovie, DirectShow and kbmm.

Back to the top

### New Since ActiveMovie 1.0

- MIDI file playback support.
- Multimedia stream interfaces. See About the Multimedia Streaming Architecture in the documentation.
- Improved Filter Graph Editor (GraphEdt.exe) SDK tool.
- Integration with the DirectAnimation run time.
- New samples, headers, and libraries for developers to use and modify, including the "AMCap" audio/video capture application (see samples\dshow\capture).
- VFW Capture filter. Wraps Video for Windows capture drivers
- Audio Capture filter. Wraps waveIn sound drivers
- AVI Compressor filter. Uses ICM compressors to compress video.
- AVI Draw filter. Allows access to hardware based ICM video decompressors.
- AVI Mux filter. Multiplexes streams into an AVI stream suitable for a file writer.
- File Writer filter.
- Capture graph building interface (ICaptureGraphBuilder). See AMCap sample (see samples\dshow\capture) and documentation for usage.
- All capture related interfaces are defined in axextend.idl and also documented in the documentation.
- DirectSound audio renderer. Includes 3-D and arbitrary DirectSound processing support.
- Improved ActiveX playback control. Improved scripting and Visual Basic support. ActiveMovie ActiveX playback control now by default supports: MID, RMI and WAV formats. Dynamically maintains the aspect ratio of the video when resizing through the control. To turn off the aspect ratio during a resize, hold down the CTRL key.

Back to the top

### Building the Samples

To build the DirectShow SDK samples, you must install Microsoft Visual C++ version 5.0. The header files and libraries from the DirectShow SDK are also required.

To build all the samples, run nmake in the \samples\dshow directory. Debug versions will be built by default. To produce non-debug versions set the 'nodebug' environment variable (that is, set nodebug=1), or type nmake NODEBUG=1.

Back to the top

### Known Issues and Troubleshooting

The following is a list of current problems. Some of them have already been fixed; those fixes will appear in upcoming releases.

General

Trouble Shooting

- Installation Problems
  - Problem: I am receiving an error copying files when installing the SDK or run time on NT.
  - Solution: DirectX Media requires that the user be an administrator for installing. Please modify your installation program to require administrative privileges before installing.
  - Problem: I am receiving an error using DirectShow property pages on NT ALPHA.
  - Solution: Make sure you have NT ALPHA SP3 installed with the DirectX Media run time.
- Capture
  - Problem: I would like to improve my capture performance using DirectShow.
  - Solution: Please read the Improving Capture Performance section of your DirectShow documentation.
  - Problem: My capture card does not work correctly with the new DirectShow.
  - Solution: Please contact your capture card manufacturer for the latest drivers. Many problems you encounter with capture can be solved by simply obtaining the latest drivers.
- DVD
  - Problem: I am encountering problems playing DVD on a 640x480 or a very high resolution and/or color depth.
  - Solution: Change your screen resolution to 800x600, and/or lower the color depth.
- DV
  - Problem: The DV Muxer won't accept an audio stream unless a video stream is already connected.
  - Solution: If you just want to write audio data, send black video frames to the Mux as well.

Known Issues

- Capture
  - The Broadway card does not capture with the AMCap application.
- Setup
  - DirectShow requires SP3 on NT ALPHA only.
  - Setup requires the user be logged on as an administrator.
  - The DirectX Media run time installation installs a minimum version of DirectX. If your application is going to install DirectX 5.0, make sure that it installs DirectX 5.0 after the DirectX Media run time.
- DVD
  - ChapterPlayAutoStop and ChapterPlay calls are only allowed in VTSM, VMGM, or TT Domains.

Back to the top

### Documentation Additions

The following is a list of additions to the DirectShow documentation.

- To add an element to an existing cutlist after the graph has been rendered, you must call ICutListGraphBuilder::RemoveCutlist to remove the cutlist from the filter graph, then call IStandardCutList::AddElement to add the new cutlist element, then call ICutListGraphBuilder::AddCutList to add the cutlist to the filter graph, and then call ICutListGraphBuilder::Render to create the final cutlist filter graph.
- For the ulParentalLevel parameter of the IDvdControl::ParentalLevelSelect method, you should specify one of the following values.
    1 - means the rating is G, General.
    3 - means the rating is PG, Parental Guidance Suggested.
    4 - means the rating is PG13, Parental Guidance Suggested, not recommended for those under 13.
    6 - means the rating is R, Restricted.
    7 - means the rating is NC17.

Back to the top

### Contact Information

> Development questions, feature requests, and business opportunities for those developing tools or content based on DirectShow should be addressed to: dxmbeta@microsoft.com.

> Bugs should be reported to dxmbug@microsoft.com

> DirectShow has created public news groups on the Microsoft Public News Server, as a forum for the DirectX media user community. You are encouraged to post questions on the appropriate news group:

> - microsoft.public.multimedia.directx.dshow.activemovie — a newsgroup for users of the DirectShow control.
> - microsoft.public.multimedia.directx.dshow.programming — a newsgroup for programmers of the DirectShow API.

Back to the top

### Capture Hardware Tested with this Release

The following capture hardware has been successfully tested in this release using the DirectShow audio and video capture filters (as appropriate):

- Truevision TARGA 2000 Pro, DTX, and RTX
- miro Computer Products miroVIDEO DC30
- miro Computer Products miroVIDEO DC20 (Win95)
- Creative Labs Sound Blaster AWE32 PnP
- FAST Electronic AV Master
- Winnov Videum AV
- Connectix Color QuickCam
- Broadway
- ATI All in Wonder
- Intel Smart Video Recorder III

Back to the top