Microsoft DirectX 8.1 (C++)

IAMCollection::Item

The Item method retrieves an item from the collection using an index.

Syntax

HRESULT Item(
  long lItem,
  IUnknown **ppUnk
);

Parameters

lItem

[in]  Specifies the index into the collection as a long integer.

ppUnk

[out]  Specifies a pointer and IUnknown pointer to receive the address of the IUnknown interface of the item in the collection at that index.

Return Values

When this method succeeds, it returns S_OK. Otherwise it returns an HRESULT error code.

Remarks

The returned ppUnk parameter points to an interface corresponding to the type of objects in the container. It can be IFilterInfo, IPinInfo , or IMediaTypeInfo.

The index is zero-based.

See Also