ICodecAPI::SetValueWithNotify method (strmif.h)

12/05/2018
2 minutes to read

The SetValueWithNotify method sets a property on a codec and returns a list of other properties that changed as a result.

Syntax

HRESULT SetValueWithNotify(
  const GUID *Api,
  VARIANT    *Value,
  GUID       **ChangedParam,
  ULONG      *ChangedParamCount
);

Parameters

Api

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

Value

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

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.

ChangedParamCount

Receives the number of elements in the ChangedParam array.

Return value

This method can return one of these values.

Return code	Description
S_OK	The method succeeded.
E_NOTIMPL	Not implemented.

Remarks

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

Requirements


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