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