Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

Provides an array of pointers to IPinobjects. These are the pins that this pin internally connects to.

Syntax

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

Parameters

apPin

Array of IPinpointers.

nPin

Upon input, indicates the number of channels; upon output, indicates the number of pins.

Return Value

Returns one of the following HRESULTvalues.

Value Description

E_FAIL

Undetermined failure.

E_NOTIMPL

The filter graph manager interprets E_NOTIMPL as meaning all input pins connect to all output pins.

S_FALSE

Insufficient number of channels; returns no pins in apPin.

Remarks

This member function implements the IPin::QueryInternalConnectionsmethod but only to return E_NOTIMPL.

To provide mapping between specific input and output pins, override this.

The default implementation to return E_NOTIMPL implies that the caller can assume that all input pins feed all output pins.

Overriding this member function allows a filter to specify when it is a renderer for some of its input pins and not for others.

Requirements

Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later
Note Microsoft 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