IAMStreamConfig interface (strmif.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
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).
Inheritance
The IAMStreamConfig interface inherits from the IUnknown interface. IAMStreamConfig also has these types of members:
Methods
The IAMStreamConfig interface has these methods.
| IAMStreamConfig::GetFormat The GetFormat method retrieves the current or preferred output format. |
| IAMStreamConfig::GetNumberOfCapabilities The GetNumberOfCapabilities method retrieves the number of format capabilities that this pin supports. |
| IAMStreamConfig::GetStreamCaps The GetStreamCaps method retrieves a set of format capabilities. |
| IAMStreamConfig::SetFormat The SetFormat method sets the output format on the pin. |
Remarks
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.Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |