Microsoft DirectX 8.1 (C++)

CSource::FindPin

The FindPin method retrieves the pin with the specified identifier. This method implements the IBaseFilter::FindPin method.

Syntax

HRESULT FindPin(
    LPCWSTR Id,
    IPin **ppPin
);

Parameters

Id

Pointer to a null-terminated string that identifies the pin.

ppPin

Address of a variable that receives a pointer to the pin's IPin interface. If the method fails, *ppPin is set to NULL

Return Value

Returns one of the HRESULT values shown in the following table.

Value Description
S_OK Success.
E_POINTER NULL pointer argument.
VFW_E_NOT_FOUND Could not find a pin with this identifier.

Remarks

The first pin is always named "1"; the second pin is named "2"; and so forth. For more information, see CSourceStream::QueryId.

See Also