IAMStreamConfig Interface

Microsoft DirectShow 9.0

IAMStreamConfig Interface

The IAMStreamConfig interface sets the output format on certain capture and compression filters, for both audio and video. Applications can use this interface to set format properties, such as the output dimensions and frame rate (for video) or the sample rate and number of channels (for audio).

Filters expose this interface on their output pins. To use the interface, enumerate the filter's pins and query for IAMStreamConfig. Or, if you are using the Capture Graph Builder object to build the filter graph, you can call the ICaptureGraphBuilder2::FindInterface method. Note that a capture filter might have separate pins for capture and preview.

Filter developers: If you are writing a capture filter or compression filter, implement this interface on the video or audio output pin. For more information, see Exposing Capture and Compression Formats.

In addition to the methods inherited from IUnknown, the IAMStreamConfig interface exposes the following methods.

Method	Description
GetFormat	Retrieves the current or preferred output format.
GetNumberOfCapabilities	Retrieves the number of format capabilities that this pin supports.
GetStreamCaps	Retrieves a set of format capabilities.
SetFormat	Sets the output format on the pin.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.