1动态的重新连接
在进行pin连接的时候,应用程序一般都要讲graph停掉。但是,一些filter支持pin的动态连接。
图1
如上图,我们想将Filter 2动态移走。有两个必要条件:
(1)Filter 3 (pin D)必须支持IPinConnection接口(这个接口能够保证Filter在非Stopped状态下也能进行Pin的重连);
(2)Filter1上的输出pin,也就是pin A,在重新连接的过程中必须要将发送数据的线程阻塞,在重连的时候,pin A和pin D中不允许数据的传输, 如果“重连”是由Filter 1发起的(在Filter内部完成),那么Filter 1要有内部机制来阻塞数据发送线程;如果“重连”由应用程序来完成,则要求Filter 1 (pin A)实现IPinFlowControl接口。
动态重连的一般步骤如下:
(1)在Filter 1(pin A)上阻塞数据流线程。
(2)重连Pin A和Pin D,必要时插入新的Filter。
(3)再次启动Filter 1(pin A)上的数据发送线程。
下面先来看看第一步;
(1)在Filter 1(pin A)上阻塞数据流线程。
IPinFlowControl::Block可以工作在同步和异步两种模式下。
如果在异步方式下使用Block函数,要首先创建一个win32事件,然后将这个事件句柄作为参数传递给block函数,这个函数会立即返回,然后调用WaitForSingleObject方法等待事件被触发。如下:
// Create an event
HANDLE hEvent = CreateEvent(NULL, FALSE, FALSE, NULL);
if (hEvent != NULL)
{
// Block the data flow.
hr = pFlowControl->Block(AM_PIN_FLOW_CONTROL_BLOCK, hEvent);
if (SUCCEEDED(hr))
{
// Wait for the pin to finish.
DWORD dwRes = WaitForSingleObject(hEvent, dwMilliseconds);
}
}
如何用同步的方式调用Block函数,只需给它传递一个NULL的参数即可。这样这个函数就会一直阻塞下去,直到pin完全做好准备可以传递sample,阻塞停止。如果filter处于paused状态,阻塞时间也许会无限延长,因此,不要在你的主线程中采用同步的方式调用这个函数,可以新开一个线程或者采用异步的方式。
(2)重连Pin A和Pin D,必要时插入新的Filter。
这里Pin的重连可以使用IGraphConfig::Reconnect或IGraphConfig::Reconfigure(IGraphConfig接口可以从Filter Graph Manager上获得)。Reconnect比Reconfigure使用起来要简单,它主要作如下几件事:
1将Filter 2置于Stopped状态,然后将其移走;
2如果需要,可以在filter graph中增加新的Filter;
3重新连接相关的各个Pin;
4将新加入的Filter置于Paused或Running状态,以使其与Filter Graph同步。示例如下:
pGraph->AddFilter(pNewFilter, L"New Filter for the Graph");
pConfig->Reconnect(
pPinA, // Reconnect this output pin...
pPinD, // ... to this input pin.
pMediaType, // Use this media type.
pNewFilter, // Connect them through this filter.
NULL,
0);
实际应用中,如果你觉得Reconnect不够灵活,还可以改用Reconfigure方法。这个方法可以通过应用程序中的回调函数来重新连接pin。使用Reconfigure方法,你必须在你的应用程序里实现IGraphConfigCallback接口;
在Reconfigure调用之前,还要如前所述,阻塞数据发送线程,然后通过以下步骤将海没有处理得数据发送下去:
1调用filter最末端的输入pin上的IPinConnection::NotifyEndOfStream。在这个例子里就是pin D。给这个pin传递一个win32事件
2然后在和上游需要阻塞发送数据的filter的输出pin相连的输入pin上调用IPin::EndOfStream方法,这个例子,上游最远端得数据输出pin是pin A,那么和它相连的输入pin就是pin B了,就调用pin B上的IPin::EndOfStream方法。
3等待触发事件。当Pin D接收到一个end of stream通知的时候,表明graph中已经没有数据流在传递了,可以安全的进行pin的重新连接了。
这些处理IGraphConfig::Reconnect会自动给我们完成 。
(3)再次启动Filter 1(pin A)上的数据发送线程。
只需调用IPinFlowControl::Block,如下:pFlowControl->Block(0, NULL);
过滤器链(Filter Chains)
首先要弄明白什么是Filter Chain。见下图:
图2
1 Filter Chain是相互连接着的一条Filter链路,并且链路中的每个Filter至多有一个Input pin,至多有一个Output pin;
2 这条Filter链路中的数据流不依赖于链路外的其他Filter。
如上图中,A–B,C–D,F–G–H,F–G,G–H都是Filter Chain,同时Filter链也可以只包括一个filter,因此A,B,C,D,E,F,G也都是独立的链,因为E含有两个输入pin,因此任何含有E的都不是Filter Chain。
Filter Chain通过IFilterChain接口来操作的,该接口可以从Filter Graph Manager上获得。
IFilterChain提供了下面的方法用来操作filter链。
IFilterChain::StartChain 开始一个链条
IFilterChain::StopChain 停止一个链条
IFilterChain::PauseChain 暂停一个链条
IFilterChain::RemoveChain 将一个链条从graph中删除
并没有一个特殊的方法用来添加一个chain,它和正常的添加filter的方法一样,首先用IFilterGraph::AddFilter 在graph中添加一个filter,然后就是IGraphBuilder::Connect, IGraphBuilder::Render等诸如此类的方法。
当Graph在运行的时候,Filter Chain可以在Running和Stopped状态之间切换;当Graph在暂停状态下,Filter Chain可以在Paused和Stopper状态之间切换。以上是Filter Chain仅有的两种状态转换。
Filter Chain的使用规则
当你使用IFilterChain的方法时,你一定要确保graph中的filter都支持这个接口,否则的话你也可能会造成死锁和graph错误。
下面将教给你如何正确使用filter chain
图3
1 在链条的状态改变之前,在链条边界的数据处理必须完成。下面的函数可以完成这些事情:IMemInputPin::Receive, IPin::NewSegment, and IPin::EndOfStream。
Filters in the chain must return from calls to these methods made by filters outside the chain; and filters outside the chain must return from calls made by filters within the chain.
例如:上面图中,filter B必须将从filter A中请求的数据处理完毕,filter E必须完成对filter D请求的数据的处理。
2 上游的filter必须能够察觉filter 链表的状态改变。例如,在上图中,假如chain停止,但是filter A却调用B上的输入pin上的IMemInputPin::Receive方法,调用肯定是失败的,并且返回的信息是stream 停止。如果当应用程序重新启动chain的时候,filter A就没有数据流了。
3chain下游的filter也应该能够察觉链表状态的改变。如果不能够察觉的话,如果E阻塞等待上游的D传递sample,但是上游的chain的状态已经改变成停止状态,容易造成死锁。
4所有和链表内的filter 相连的filter都应该有自己独立的allocator,因为如果chain的状态改变或者被删除,它的allocator就会被销毁,和它们相连的filter就没法处理sample了。
5只有链表支持动态断开才能将一个链表从graph中移走。