ITuningSpaceContainer::get_Item method (tuner.h)

Article
12/05/2018

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

The get_Item method retrieves a tuning space with the specified ID.

Syntax

HRESULT get_Item(
  [in]  VARIANT      varIndex,
  [out] ITuningSpace **TuningSpace
);

Parameters

[in] varIndex

VARIANT that specifies the ID of the tuning space.

[out] TuningSpace

Address of an ITuningSpace interface pointer that will be set to the returned interface.

Return value

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

Remarks

Tuning spaces are identified by ID number. The ID number is unique within the collection. The range of valid IDs is not guaranteed to be contiguous; there may be holes if tuning spaces are added and then removed.

Examples


CComPtr <ITuningSpaceContainer>  pTuningSpaceContainer;
// Create the SystemTuningSpaces object (not shown).

long cCount = 0;
long ID = 1; // zero is not a valid ID.
hr = pTuningSpaceContainer->get_Count(&cCount);
if (SUCCEEDED(hr))
{
    while (cCount)
    {
        CComPtr<ITuningSpace> pTuningSpace;
        CComVariant varIndex(ID);
        hr = pITuningSpaceContainer->get_Item(varIndex, &pTuningSpace);
        if (SUCCEEDED(hr))
        {
             // pTuningSpace now points to the tuning space with this ID.
             --cCount;
        }
        ID++; // increment for the next ID.
    }
}

Requirements


Minimum supported client	Windows�XP [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	tuner.h

Share via