Microsoft DirectX 9.0


The QueryInternalConnections method retrieves the pins that are connected internally to this pin (within the filter).


HRESULT QueryInternalConnections(
  IPin **apPin,
  ULONG *nPin



[out] Address of an array of IPin pointers.


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


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.