IPin::QueryInternalConnections

Windows Mobile 6.5
A version of this page is also available for
4/8/2010

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.

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.

Windows Embedded CEWindows CE 2.12 and later
Windows MobilePocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later
NoteMicrosoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later

Community Additions

Show: