Edit

Share via

ICodecAPI::SetValueWithNotify method (icodecapi.h)

  • Article

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.

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

Requirement Value
Minimum supported client Windows 10 Build 20348
Minimum supported server Windows 10 Build 20348
Header icodecapi.h

See also

Codec API Reference

Encoder API

ICodecAPI

ICodecAPI::GetValue