| Microsoft DirectX 8.1 (C++) |
The QueryInternalConnections method retrieves the pins that are connected internally to this pin (within the filter).
Syntax
HRESULT QueryInternalConnections(
IPin **apPin,
ULONG *nPin
);
Parameters
apPin
[out] Address of an array of IPin pointers.
nPin
[in, out] On input, specifies the size of the array. When the method returns, the value is set to the number of pointers returned in the array.
Return Value
Returns an HRESULT value. Possible values include the following.
| Value | Description |
| S_FALSE | Insufficient array size. |
| S_OK | Success. |
| E_FAIL | Failure. |
| E_NOTIMPL | Not implemented. |
Remarks
On some filters, input pins correspond to particular output pins. For each pin, this method fills an array with pointers to the corresponding pins. If every input pin provides data for every output pin, the pin returns E_NOTIMPL.
If the method succeeds and returns a value of *nPin greater than zero, the array contains pointers to IPin interfaces. Be sure to release each interface pointer when you are done.