 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 the IPininterface of the pins to which this pin internally connects.
HRESULT QueryInternalConnections( IPin ** apPin , ULONG * nPin );
Parameters
- apPin
- [out] Array of IPinpointers.
- nPin
- [out] Upon input, indicates the number of array elements; upon
output, indicates the number of pins.
Return Values
Returns one of the following HRESULTvalues.
E_FAIL Undetermined. S_FALSE Insufficient number of array elements to return all the results, in which case no pins are returned in the apPinarray. E_NOTIMPL Filter graph manager interprets E_NOTIMPL as meaning that any input pin connects to all visible output pins, and vice versa. Remarks
All pins put in the array are added by the IUnknown::AddRefmethod. The apPinparameter can be NULL if the nPinparameter equals zero. This allows the calling application to determine the number of required arrays.
This method is implemented in the base classes by CBasePin::QueryInternalConnections.