IPin::QueryInternalConnections

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

Syntax

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

Parameters

apPin

[out] Address of an array of IPin pointers.

nPin

[in, out] 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 an HRESULT value. Possible values include the following.

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, the pin returns E_NOTIMPL.

If the method succeeds and returns a value of *nPin greater than zero, the array contains pointers to IPin interfaces. Be sure to release each interface pointer when you are done.