Share via


IMSVidAudioRendererDevices::get_Item method (segment.h)

[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 the specified item from the collection.

Syntax

HRESULT get_Item(
  [in]  VARIANT             v,
  [out] IMSVidAudioRenderer **pDB
);

Parameters

[in] v

VARIANT that specifies the index of the item to retrieve.

[out] pDB

Address of a variable that receives an IMSVidAudioRenderer interface pointer.

Return value

Returns an HRESULT value. Possible values include the following.

Return code Description
S_OK
Success.
DISP_E_BADINDEX
The index is out of range.
DISP_E_TYPEMISMATCH
Wrong VARIANT type.
E_POINTER
NULL pointer argument.
E_UNEXPECTED
Unexpected error.

Remarks

The v parameter must be a VARIANT that contains an integer type (VT_I4). The valid range is from 0 to IMSVidAudioRendererDevices::get_Count - 1.

If the method succeeds, the IMSVidAudioRenderer interface has an outstanding reference count. The caller must release the interface.

Requirements

Requirement Value
Minimum supported client Windows�XP [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header segment.h (include Msvidctl.h)

See also

IMSVidAudioRendererDevices Interface