IMediaParams::AddEnvelope

 
Microsoft DirectShow 9.0

IMediaParams::AddEnvelope

The AddEnvelope method adds an envelope to a parameter.

Syntax

  HRESULT AddEnvelope(
    DWORD dwParamIndex,
    DWORD cPoints,
    MP_ENVELOPE_SEGMENT *pEnvelope,
);

Parameters

dwParamIndex

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

cPoints

[in] Number of segments in the envelope.

pEnvelope

[in] Pointer to an array of MP_ENVELOPE_SEGMENT structures that define the envelope segments. The size of the array is given in the cPoints parameter.

Return Values

Returns an HRESULT value. Possible values include the following.

Return Code Description
E_INVALIDARG Index out of range.
E_OUTOFMEMEORY Insufficient memory.
E_POINTER NULL pointer argument.
S_OK Success.

Remarks

The caller should add envelopes in time-ascending order. Otherwise, the results on playback are indeterminate. If one envelope overlaps another, the later envelope takes precedence.

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

Example Code

The following code sets two envelope segments, both using a linear function.

#define MSEC 10000  // One millisecond

// Define an array with two segments. Note the segments appear in 
// time-ascending order.
MP_ENVELOPE_SEGMENT Segments[] =
{
    {  
        0,                  // rtStart
        3 * MSEC,           // rtStop
        0,                  // valStart
        12,                 // valStop
        MP_CURVE_LINEAR,    // iCurve
        MPF_ENVLP_STANDARD  // flags
    },
    {  
        6 * MSEC,
        9 * MSEC,
        12,
        0,
        MP_CURVE_LINEAR,
        MPF_ENVLP_STANDARD
    }
};
// Define the number of segments in the array.
DWORD cSegments = sizeof(Segments) / sizeof(Segments[0]);
DWORD dwParam = 0;  // Which parameter to set.

hr = pMediaParams->AddEnvelope(dwParam, cSegments, Segments);

This example assumes that the caller has previous used the IMediaParamInfo interface to query whether the DMO supports the MP_CURVE_LINEAR curve for that parameter.

Requirements

  Header: Medparam.h
  Library: Dmoguids.lib.

See Also