This method provides an array of pointers to the IPin interface of the pins to which this pin internally connects.

HRESULT QueryInternalConnections(
  IPin** apPin,
  ULONG* nPin


  • apPin
    [out] Array of IPin pointers.
  • nPin
    [out] Upon input, indicates the number of array elements; upon output, indicates the number of pins.

Return Values

Returns one of the following HRESULT values.

Value Description
E_FAIL Undetermined.
S_FALSE Insufficient number of array elements to return all the results, in which case no pins are returned in the apPin array.
E_NOTIMPL Filter graph manager interprets E_NOTIMPL as meaning that any input pin connects to all visible output pins, and vice versa.


All pins put in the array are added by the IUnknown::AddRef method. The apPin parameter can be NULL if the nPin parameter equals zero. This allows the calling application to determine the number of required arrays.

This method is implemented in the base classes by CBasePin::QueryInternalConnections.


DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.

See Also

IPin Interface

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.