IConfigAsfWriter interface (dshowasf.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 IConfigAsfWriter interface configures the WM ASF Writer filter. It provides methods for getting and setting the profiles and indexing mode.
When the WM ASF Writer filter is created, it is configured automatically with a default ASF audio-visual profile based on the incoming streams. A profile describes various attributes of an ASF file such as bit rate, number and type of streams, compression quality, and so on. The filter uses the profile to determine what kind of ASF file to write, how many input pins to create, and what media types to accept. When the WM ASF Writer filter is first created, it is configured automatically with the following default profile: WMProfile_V80_256Video. However, using this profile is not recommended because it does not use the Windows Media Audio and Video 9 Series codecs.
Inheritance
The IConfigAsfWriter interface inherits from the IUnknown interface. IConfigAsfWriter also has these types of members:
Methods
The IConfigAsfWriter interface has these methods.
| IConfigAsfWriter::ConfigureFilterUsingProfile The ConfigureFilterUsingProfile method sets an ASF profile on the WM ASF Writer filter. This method is the recommended way to set a profile on the WM ASF Writer filter. |
| IConfigAsfWriter::ConfigureFilterUsingProfileGuid The ConfigureFilterUsingProfileGuid method sets a predefined system profile on the WM ASF Writer filter. This method is deprecated. Applications should use the IConfigAsfWriter::ConfigureFilterUsingProfile method to set the profile. |
| IConfigAsfWriter::ConfigureFilterUsingProfileId The ConfigureFilterUsingProfileId method sets a Windows Media Format 4.0 profile on the WM ASF Writer filter. This method is deprecated. Applications should use the IConfigAsfWriter::ConfigureFilterUsingProfile method to set the profile. |
| IConfigAsfWriter::GetCurrentProfile The GetCurrentProfile method retrieves the current ASF profile from the WM ASF Writer filter. |
| IConfigAsfWriter::GetCurrentProfileGuid The GetCurrentProfileGuid method retrieves the GUID of the WM ASF Writer filter's current system profile, if any. (Deprecated.). |
| IConfigAsfWriter::GetCurrentProfileId The GetCurrentProfileId method retrieves the identifier of the WM ASF Writer filter's profile, only when the filter is using a Windows Media Format 4.0 profile. (Deprecated.). |
| IConfigAsfWriter::GetIndexMode The GetIndexMode method retrieves the current index mode. |
| IConfigAsfWriter::SetIndexMode The SetIndexMode method controls whether the WM ASF Writer filter creates a file with a temporal index. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | dshowasf.h |