Export (0) Print
Expand All

ICodecAPI::SetValueWithNotify method

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

Api [in]

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

Value [in]

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

ChangedParam [out]

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 [out]

Receives the number of elements in the ChangedParam array.

Return value

This method can return one of these values.

Return codeDescription
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 | Windows Store apps]

Minimum supported server

Windows Server 2003 R2 [desktop apps | Windows Store apps]

Header

Strmif.h (include Dshow.h)

Library

Strmiids.lib

See also

Codec API Reference
ICodecAPI
ICodecAPI::GetValue
Encoder API

 

 

Community Additions

ADD
Show:
© 2015 Microsoft