Microsoft DirectX 8.1 (C++)

IMSVidInputDevices::get_Item

This topic applies to Windows XP Home Edition and Windows XP Professional only.

The get_Item method retrieves the specified item from the collection.

Syntax

HRESULT get_Item(
  VARIANT  v,
  IMSVidInputDevice**  ppDB
);

Parameters

  v

[in]  VARIANT that specifies the index of the item to retrieve.

  ppDB

[out]  Address of a variable that receives an IMSVidInputDevice interface pointer.

Return Values

Returns an HRESULT value. Possible values include the following.

Value 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 IMSVidInputDevices::get_Count() - 1.

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

See Also