IMSVidInputDevices::get_Item

Microsoft DirectShow 9.0

IMSVidInputDevices::get_Item

This topic applies to Windows XP or later.

The get_Item method retrieves the specified item from the collection.

Syntax

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

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.

Requirements

  Header: Dshow.h.

  Library: Quartz.dll.

See Also

• IMSVidInputDevices Interface