CBasePin::QueryInternalConnections
A version of this page is also available for
4/8/2010
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
| 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 |