CBasePin::QueryInternalConnections (Compact 2013)

3/26/2014

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

Syntax

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 Value

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.

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

Header

dshow.h,
Streams.h

Library

ole32.lib,
Ole32auth.lib,
Strmbase.lib,
Strmiids.lib,
uuid.lib

See Also

Reference

CBasePin Class