ICodecAPI::SetAllSettingsWithNotify method (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 SetAllSettingsWithNotify method reads codec properties from a stream, sets them on the codec, and returns a list of the properties that changed.
Syntax
HRESULT SetAllSettingsWithNotify(
[in] IStream *__MIDL__ICodecAPI0002,
[out] GUID **ChangedParam,
[in] ULONG *ChangedParamCount
);
Parameters
[in] __MIDL__ICodecAPI0002
Pointer to the IStream interface of the stream.
[out] ChangedParam
Receives a pointer to an array of GUIDs. The array contains the GUIDs of any properties that changed as a result of this method call. The caller must free the array by calling CoTaskMemFree.
[in] ChangedParamCount
Receives the number of elements in the ChangedParam array.
Return value
This method can return one of these values.
Return code | Description |
---|---|
|
The method succeeded. |
|
Not implemented. |
Remarks
Codecs that implement ICodecAPI are not required to support this method.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP with SP2 [desktop apps | UWP apps] |
Minimum supported server | Windows Server 2003 R2 [desktop apps | UWP apps] |
Target Platform | Windows |
Header | strmif.h (include Dshow.h) |
Library | Strmiids.lib |