CEnumPins::Next

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Places pointers to IPin interfaces into the specified array.

Syntax

HRESULT Next(
  ULONG cPins,
  IPin** ppPins,
  ULONG* pcFetched 
);

Parameters

• cPins
  Number of pins to place.

• ppPins
  Array in which to place the interface pointers.

• pcFetched
  Actual number of pins placed in the array.

Return Value

Returns an HRESULT value.

Remarks

This member function implements the IEnumPins::Next method.

The derived class is responsible for implementing CBaseFilter::GetPin, which this member function calls to retrieve the next pin.

Because this member function returns one or more interfaces that have had their reference counts incremented, the caller of this member function must be sure to release the interfaces by calling IUnknown::Release on the interfaces when done with them.

Requirements