IMediaParams::SetParam

The SetParam method sets the value of a parameter.

Syntax

HRESULT SetParam(
    DWORD dwParamIndex,
    MP_DATA value
);

Parameters

dwParamIndex

[in] Zero-based index of the parameter, or DWORD_ALLPARAMS to apply the value to every parameter.

value

[in] New value of the parameter.

Return Values

Returns an HRESULT value. Possible values include the following.

Return Code Description
E_INVALIDARG Index out of range, or illegal parameter value.
S_OK Success.

Remarks

If the parameter is currently within an envelope segment, the envelope segment will overwrite the new value. To remove an envelope segment, call the FlushEnvelope method.

To enumerate the parameters supported by this object, along with their index values, use the IMediaParamInfo interface.

Requirements

  Header: Medparam.h
  Library: Dmoguids.lib.

See Also

© 2004 Microsoft Corporation. All rights reserved.