Microsoft DirectX 8.1 (C++)

CBaseFilter::EnumPins

The EnumPins method enumerates the pins on this filter. This method implements the IBaseFilter::EnumPins method.

Syntax

HRESULT EnumPins(
    IEnumPins **ppEnum
);

Parameters

ppEnum

Address of a variable that receives a pointer to the IEnumPins interface.

Return Value

Returns one of the following HRESULT values.

Value Description
S_OK Success
E_OUTOFMEMORY Insufficient memory
E_POINTER NULL pointer argument

Remarks

This method creates an instance of the CEnumPins base class, and returns a pointer to that object, of type IEnumPins. The CEnumPins class calls the filter's CBaseFilter::GetPin method to enumerate the pins on the filter.

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

See Also