CBasePin::QueryInternalConnections

  • Article

Provides an array of pointers to IPin objects. These are the pins to which this pin internally connects.

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

Parameters

  • apPin
    Array of IPin pointers.
  • nPin
    Upon input, indicates the number of channels; upon output, indicates the number of pins.

Return Values

Returns one of the following HRESULT values.

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::QueryInternalConnections method but only to return E_NOTIMPL. Override this if you want to provide mapping between specific input and output pins.

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

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.
Header:

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.