ITuningSpaceContainer::put_Item

 
Microsoft DirectShow 9.0

ITuningSpaceContainer::put_Item

The put_Item method saves changes to an existing tuning space in the collection.

Syntax

  HRESULT put_Item(
    VARIANT varIndex,
    ITuningSpace* pTuningSpace
    );

Parameters

varIndex

[in]  VARIANT that specifies the index of the tuning space.

pTuningSpace

[in] Pointer to the ITuningSpace interface of the tuning space.

Return Values

Returns an HRESULT. Possible values include those in the following table.

Return code Description
E_INVALIDARG Invalid argument.
E_POINTER NULL pointer argument.
S_OK Success.

If the method fails, error information can be retrieved using the standard COM IErrorInfo interface.

Remarks

An application can retrieve an existing tuning space from the collection, modify its properties by calling ITuningSpace methods, and then call put_Item to save the changes. The unique name property on the tuning space must match the tuning space at the specified index in the collection; otherwise, the method returns E_INVALIDARG.

To add a new tuning space, use the ITuningSpaceContainer::Add method.

Requirements

  Header: Dshow.h.

  Library: Quartz.dll.

See Also