IFilterGraph2::ReconnectEx

This method specifies a pin and a media type to reconnect with.

HRESULT ReconnectEx(
  IPin* ppin,
  const AM_MEDIA_TYPE* pmt
);

Parameters

  • ppin
    [in] Pin to disconnect and reconnect.
  • pmt
    [in] Media type to reconnect with. Specify NULL to use the existing media type.

Return Values

Returns an HRESULT value that depends on the implementation of the interface.

Remarks

Like the IFilterGraph::Reconnect method, the ReconnectEx method schedules a reconnection of the pin with the pin it is currently connected to. By specifying a media type when this method is called, the pins do not have to check what type they were originally connected with or enumerate possible new types. This makes the reconnection more likely to succeed.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.

See Also

IFilterGraph2 Interface | IFilterGraph::Reconnect

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.