ITuningSpaceContainer::put_Item Method

Article
01/07/2009

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

Syntax

HRESULT put_Item(
  [in]  VARIANT varIndex,
  [in]  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 Value

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	Declared in Dshow.h.
DLL	Requires Quartz.dll.

Share via