ICodecAPI::SetValueWithNotify 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 SetValueWithNotify method sets a property on a codec and returns a list of other properties that changed as a result.

Syntax

HRESULT SetValueWithNotify(
  [in]  const GUID *Api,
  [in]  VARIANT    *Value,
  [out] GUID       **ChangedParam,
  [out] ULONG      *ChangedParamCount
);

Parameters

[in] Api

Pointer to a GUID that specifies the property to set. For a list of standard codec properties, see Codec API Properties.

[in] Value

Pointer to a VARIANT that contains the new value for the property.

[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.

[out] ChangedParamCount

Receives the number of elements in the ChangedParam array.

Return value

This method can return one of these values.

Remarks

Codecs that implement ICodecAPI are not required to support this method.

Requirements

See also

Codec API Reference

Encoder API

ICodecAPI

ICodecAPI::GetValue