Microsoft DirectX 8.1 (C++)

CBasePin::QueryInternalConnections

The QueryInternalConnections method retrieves the pins that are connected internally to this pin (within the filter). This method implements the IPin::QueryInternalConnections method.

Syntax

HRESULT QueryInternalConnections(
    IPin *apPin,
    ULONG *nPin
);

Parameters

apPin

Address of an array of IPin pointers.

nPin

On input, specifies the size of the array. When the method returns, the value is set to the number of pointers returned in the array.

Return Value

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

Value Description
S_FALSE Insufficient array size.
S_OK Success.
E_FAIL Failure.
E_NOTIMPL Not implemented.

The base class returns E_NOTIMPL.

Remarks

On some filters, input pins correspond to particular output pins. For each pin, this method fills an array with pointers to the corresponding pins. If every input pin provides data for every output pin, return E_NOTIMPL.

See Also