ICodecAPI::SetValueWithNotify

 
Microsoft DirectShow 9.0

ICodecAPI::SetValueWithNotify

The SetValueWithNotify method sets the value of a parameter, and returns a list of other settings that have changed as a result.

Syntax

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

Parameters

[in] Api

Pointer to a GUID that specifies the parameter.

[in] Value

Pointer to a VARIANT type that contains the new value for the parameter.

[out] ChangedParam

Address of a variable that receives a pointer to an array of GUIDs, of size ChangedParamCount. The array contains the GUIDs of the parameters that have changed in the encoder as a result of this method call. The caller must free the array by calling the CoTaskMemFree function.

[out] ChangedParamCount

Pointer to a variable that receives the number of elements in the array.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also