directshow之filters 例程BALL的详细解析

最新推荐文章于 2018-03-21 10:51:13 发布
最新推荐文章于 2018-03-21 10:51:13 发布
阅读量767 收藏
点赞数
分类专栏： windows directshow 文章标签： directshow filter
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/bdmrg/article/details/42587251
版权

directshow之filters 例程BALL的详细解析

 

BALL是一个推模式的source filter，其产生一个不断撞击窗口边界的小球。编译BALL

工程，将生成ball.ax文件，用regsvr32注册该文件，打开graphedit.exe插入Bouncing Ball、Color Space Converter、Video Renderer三个filter，其中Bouncing Ball即ball.ax。将插入的三个filters连接起来，运行就可以看到下图所示的界面。

BALL工程中有三个类CBall、CBallStream、CBouncingBall,其中CBall封装了小球的行为即产生每个图像时小球应在图像中的位置。CBouncingBall继承自CSource，CSource是一个基类在BaseClasses工程中实现，CSource一般作为source filters的基类使用，CSource继承于CBaseFilter,旨在简化source Filters组件的生成，支持连续数据源的生成，因此CBouncingBall为该工程的主filter。CBallStream继承自CSourceStream，而CSourceStream又继承自CAMThread、CBaseOutputPin，其中CAMThread用于工作线程的生成，CBaseOutputPin使CBallStream类具有输出pin的特性。

1、 CBouncingBall 和CBallStream是怎么关联起来的？

在CBouncingBall的构造函数中构造了一个CBallStream实例，并将该实例的指针赋值

给m_paStreams变量，m_paStreams是CBouncingBall的父类CSource的变量，该变量用来保存SourceFilter拥有的pin。代码如下：

CBouncingBall::CBouncingBall(LPUNKNOWN lpunk, HRESULT *phr) :

   CSource(NAME("Bouncingball"),

           lpunk,

           CLSID_BouncingBall)

{

   CAutoLock cAutoLock(&m_cStateLock);

 

    m_paStreams    = (CSourceStream **) new CBallStream*[1];

    if (m_paStreams == NULL) {

        *phr = E_OUTOFMEMORY;

    return;

   }

 

    m_paStreams[0] = newCBallStream(phr, this, L"A Bouncing Ball!");

    if (m_paStreams[0] == NULL) {

        *phr = E_OUTOFMEMORY;

    return;

    }

 

} // (Constructor

2、原始数据是在什么位置产生的？

该工程的原始数据是CBallStream负责产生的，在该类的FillBuffer方法中，将产生的图像填充到MediaSample中。

HRESULT CBallStream::FillBuffer(IMediaSample *pms)

{

    BYTE *pData;

    long lDataLen;

   

    pms->GetPointer(&pData);//得到MediaSample中存储数据buffer的地址

    lDataLen = pms->GetSize();//得到存储数据buffer的大小

 

    // If true then we clear theoutput buffer and don't attempt to

    // erase a previous drawing ofthe ball - this will be the case

    // when we start running as thebuffer will be full of rubbish

    if( m_bZeroMemory ) {

        ZeroMemory( pData, lDataLen);

    }

 

    {

        CAutoLockcAutoLockShared(&m_cSharedState);

 

        // If we haven't justcleared the buffer delete the old

        // ball and move the ball on

 

        if( !m_bZeroMemory ){

            BYTE aZeroes[ 4 ] = { 0,0, 0, 0 };

           m_Ball->PlotBall(pData, aZeroes, m_iPixelSize);//画球

           m_Ball->MoveBall(m_rtSampleTime - (LONG) m_iRepeatTime);//移动球

        }

 

        m_Ball->PlotBall(pData,m_BallPixel, m_iPixelSize);//画球

 

        // The current time is thesample's start

        CRefTime rtStart =m_rtSampleTime;

 

        // Increment to find thefinish time

        m_rtSampleTime+= (LONG)m_iRepeatTime;//增加参考时间

 

       pms->SetTime((REFERENCE_TIME *) &rtStart,(REFERENCE_TIME *)&m_rtSampleTime);

    }

 

    m_bZeroMemory = FALSE;

    pms->SetSyncPoint(TRUE);

    return NOERROR;

} // FillBuffer

3、 产生的数据是怎么源源不断的传输给下游filter的？

在Graph开始运行后会调用SourceFIlterpin的Active函数，CBallStream没有

CSourceStream的Active方法，所以CSourceStream的Active方法会被调用，在Active方法中调用Create函数（CAMThread类的方法）来创建一个工作线程，线程函数为CAMThread：：InitialThreadPoc，在InitialThreadPoc函数中调用CAMThread子类（CSourceStream及其子类）的threadpoc方法进行graph需求命令的解析和执行。由于CBallStream没有实现threadpoc方法，所以调用的是CSourceStream的threadpoc方法。

   在threadpoc方法中GetRequest，并根据GetRequest的返回值做出相应动作，当返回值为CMD_PAUSE时调用DoBufferProcessingLoop来生成和传输数据。DoBufferProcessingLoop函数中先调用GetDeliveryBuffer生成一个MediaSample,然后调用FillBuffer（CBallStream重载了该函数）填充该MediaSample，最后调用Deliver函数将填充后的MediaSample向下游filter传输。

 Deliver函数是CBallStream父类CSourceStream父类CBaseOutputPIn的方法，即调用filter的输出pin的Deliver方法，Deliver方法中调用与该输出pin连接的输入pin的Receive方法将MediaSample传送给下一个Filter。而输出pin是怎么知道和它连接的输入pin的呢？CBaseOutputPin基类中定义了一个m_pInputPin的变量用来保存和它连接的输入pin，在pin连接成功时将与其连接的pin保存到m_pInputPin的变量中，这样在MediaSample传输中直接调用m_pInputPin的接收方法，就可以将数据向下传输了。这也是pin与pin直接沟通的方法，输出pin中有变量来保存与其相连的输入pin，通样的输入pin中也有变量来保存与其相连的输出pin的变量。

CSourceStream的Active函数：

HRESULT CSourceStream::Active(void) {

    CAutoLocklock(m_pFilter->pStateLock());

    HRESULT hr;

    if (m_pFilter->IsActive()) {

    return S_FALSE; // succeeded, but did not allocate resources(they already exist...)

    }

    // do nothing if not connected -its ok not to connect to

    // all pins of a source filter

    if (!IsConnected()) {

        return NOERROR;

    }

    hr = CBaseOutputPin::Active();

    if (FAILED(hr)) {

        return hr;

    }

    ASSERT(!ThreadExists());

// start the thread

// Create()函数来创建工作线程，该函数是CAMThread的方法，由于CAMThread是//CSourceStream的一个父类，用来管理工作线程。

    if (!Create()) {

        return E_FAIL;

    }

 

    // Tell thread to initialize. IfOnThreadCreate Fails, so does this.

    hr = Init();

    if (FAILED(hr))

    return hr;

    returnPause();

}

CAMThread的Create()方法：在CreateThread函数中用this作为参数传给线程函数InitialThreadProc，当在CSourceStream调用该函数时，this指向CSourceStream实例。

在InitialThreadProc函数调用了this指向实例的ThreadProc函数，即CSourceStream的ThreadProc函数

BOOL

CAMThread::Create()

{

    DWORD threadid;

 

    CAutoLocklock(&m_AccessLock);

 

    if (ThreadExists()) {

    return FALSE;

    }

  //创建线程，并以this作为线程函数的指针。

    m_hThread = CreateThread(

            NULL,

            0,

            CAMThread::InitialThreadProc,

            this,

            0,

            &threadid);

 

    if (!m_hThread) {

    return FALSE;

    }

    return TRUE;

}

CSourceStream的ThreadProc函数: ThreadProc函数有do…while循环来源源不断解析各个命名DWORD CSourceStream::ThreadProc(void) {

    HRESULT hr;  // the return code from calls

Command com;

//处理线程线程初始化

    do {

    com = GetRequest();

    if (com != CMD_INIT) {

        DbgLog((LOG_ERROR, 1, TEXT("Threadexpected init command")));

        Reply((DWORD) E_UNEXPECTED);

    }

    } while (com != CMD_INIT);

 

    DbgLog((LOG_TRACE, 1,TEXT("CSourceStream worker thread initializing")));

   // CSourceStream定义的函数，在该工程中没有做任何动作

   hr = OnThreadCreate(); // perform set up tasks

    if (FAILED(hr)) {

        DbgLog((LOG_ERROR, 1,TEXT("CSourceStream::OnThreadCreate failed. Aborting thread.")));

        OnThreadDestroy();

    Reply(hr);  // send failed return code from OnThreadCreate

        return 1;

    }

 

    // Initialisation suceeded

    Reply(NOERROR);

    //处理执行各种命令

    Command cmd;

    do {

    cmd = GetRequest();

    switch (cmd) {

    case CMD_EXIT:

        Reply(NOERROR);

        break;

    case CMD_RUN:

        DbgLog((LOG_ERROR, 1, TEXT("CMD_RUNreceived before a CMD_PAUSE???")));

        // !!! fall through???

    //在DoBufferProcessingLoop()函数中调用FillBuffer Deliver函数产生传输数据。

    case CMD_PAUSE:

        Reply(NOERROR);

        DoBufferProcessingLoop();

        break;

    case CMD_STOP:

        Reply(NOERROR);

        break;

    default:

        DbgLog((LOG_ERROR, 1, TEXT("Unknowncommand %d received!"), cmd));

        Reply((DWORD) E_NOTIMPL);

        break;

    }

    } while (cmd != CMD_EXIT);

   

    hr = OnThreadDestroy();  // tidy up.

    if (FAILED(hr)) {

        DbgLog((LOG_ERROR, 1, TEXT("CSourceStream::OnThreadDestroyfailed. Exiting thread.")));

        return 1;

    }

    DbgLog((LOG_TRACE, 1,TEXT("CSourceStream worker thread exiting")));

    return 0;

}

CSourceStream的DoBufferProcessingLoop函数：该函数的do…while结构来源源不断的产生、传输数据。在产生数据之前要先分配空间来保存数据，那么要分配多大的空间才算合适呢，这个由CBallStream类的DecideBufferSize(IMemAllocator*pAlloc,ALLOCATOR_PROPERTIES *pProperties)函数来告知内存分配对象Allocator。

HRESULT CSourceStream::DoBufferProcessingLoop(void) {

Command com;

// CSourceStream定义的函数，在该工程中没有做任何动作

OnThreadStartPlay();

//

do {

//检查com命令码是否有效

    while (!CheckRequest(&com)) {

    //分配MediaSample空间用于保存产生的样本数据

        IMediaSample *pSample;

        HRESULT hr =GetDeliveryBuffer(&pSample,NULL,NULL,0);

        if (FAILED(hr)) {

                Sleep(1);

        continue;   // go round again. Perhaps the error will goaway

                // or the allocator is decommited & wewill be asked to

                // exit soon.

        }

        // Virtual function user will override.

        //生成、填充数据

        hr = FillBuffer(pSample);

        if (hr == S_OK) {

        hr = Deliver(pSample);//传输数据

               pSample->Release();

                // downstream filterreturns S_FALSE if it wants us to

                // stop or an errorif it's reporting an error.

                if(hr != S_OK)

                {

                  DbgLog((LOG_TRACE,2, TEXT("Deliver() returned %08x; stopping"), hr));

                  return S_OK;

                }

        } else if (hr == S_FALSE) {

                // derived classwants us to stop pushing data

        pSample->Release();

        DeliverEndOfStream();

        return S_OK;

        } else {

                // derived classencountered an error

               pSample->Release();

        DbgLog((LOG_ERROR, 1,TEXT("Error %08lX from FillBuffer!!!"), hr));

               DeliverEndOfStream();

                m_pFilter->NotifyEvent(EC_ERRORABORT,hr, 0);

                return hr;

        }

            // all paths release thesample

    }

        // For all commands sent tous there must be a Reply call!

    if (com == CMD_RUN || com ==CMD_PAUSE) {

        Reply(NOERROR);

    } else if (com != CMD_STOP) {

        Reply((DWORD) E_UNEXPECTED);

        DbgLog((LOG_ERROR, 1, TEXT("Unexpectedcommand!!!")));

    }

    } while (com != CMD_STOP);

    return S_FALSE;

}

 

4、  CSourceStream类中线程函数中的命令码是怎么传输的？

CSourceStream类中线程函数中的命令码CMD_STOP等，并不是DrectShow通用的，只有CSourceStream类才实现了这样了机制（PULLPIN也实现了类似的机制TM_STOP等）。CMD_INIT这样的命令码定义在CSourceStream的头文件中。在程序指向过程中由CSourceStream发出，有CSourceStream的线程函数进行处理。在Craph开始、暂停、运行、停止时，CSourceStream放出响应的命令码，发送命令码时调用CAMThread的CallWorker传给CAMThread，在CSourceStream的线程函数中通过CAMThread的GetRequest或者CheckRequest函数获得命令码来进行响应的处理。

CSourceStream类中命令码的定义和发送

enum Command {CMD_INIT,CMD_PAUSE, CMD_RUN, CMD_STOP, CMD_EXIT};

    HRESULT Init(void) { returnCallWorker(CMD_INIT); }

    HRESULT Exit(void) { returnCallWorker(CMD_EXIT); }

    HRESULT Run(void) { returnCallWorker(CMD_RUN); }

    HRESULT Pause(void) { returnCallWorker(CMD_PAUSE); }

HRESULT Stop(void) { returnCallWorker(CMD_STOP); }

 

5、 pin连接构成中的媒体协商怎么实现的？

所谓的Filter Pin之间的连接，实际上是Pin之间Media Type（媒体类型）的一个协商过程。连接总是从输出Pin指向输入Pin的。要想深入了解具体的连接过程，就必须认真研读

SDK的基类源代码（位DXSDK\samples\Multimedia\DirectShow\BaseClasses\amfilter.cpp，类CBasePin的Connect方法）。连接的大致过程为，枚举欲连接的输入Pin上所有的媒体类型，逐一用这些媒体类型与输出Pin进行连接，如果输出Pin也接受这种媒体类型，则Pin之间的连接宣告成功；如果所有输入Pin上枚举的媒体类型输出Pin都不支持，则枚举输出Pin上的所有媒体类型，并逐一用这些媒体类型与输入Pin进行连接。如果输入Pin接受其中的一种媒体类型，则Pin之间的连接到此也宣告成功；如果输出Pin上的所有媒体类型，输入Pin都不支持，则这两个Pin之间的连接过程宣告失败。

   CBallStream类中的GetMediaType()、CheckMediaType()就是在pin媒体协商用用到的关键函数。GetMediaType()用来得到CBallStream（一个输出pin）支持的媒体类型，CheckMediaType()用来接触传入的媒体类型CBallStream（一个输出pin）是否支持。

bdmrg
关注
专栏目录
Directshow中Filter开发基础
智慧的鱼
05-26 1万+
摘要：关于开发自己的Filter，我以前写过一篇文章，《利用Directshow开发自己的filter》，里面详细介绍了开发filter一些步骤，这里我想介绍一些filter的基础知识，可以让你更好的理解filter。本篇文档主要包括下面一些内容1filter的连接2filter间的数据流动3pin连接时数据格式的动态改变4Threads and Critical Sections5质量控制管理6
DirectShow--过滤器图表（Filter Graph）和它的组件
孙涛的专栏
03-01 7117
该文用于介绍 DirectShow 的主要组件。这些组件可用于开发 DirectShow 应用程序或者用于开发自己的过滤器组件。 关于 DirectShow 过滤器(Filters) DirectShow 使用一个标准的体系结构，它的每个处理进程都是由一个 COM 对象来完成。这个 COM 对象就叫 过滤器 (Filters) 。 DirectShow 提供了一套标准的过滤器用于应用程序使
About DirectShow Filters
peterlin666的专栏
09-30 616
DirectShow uses a modular architecture, where each stage of processing is done by a COM object called a filter. DirectShow provides a set of standard filters for applications to use, and developers ca
Directshow中的Filter
Paul Joo的专栏
11-10 796
Filter是Directshow中最基本的概念。Directshow使用FilterGraph来管理Filter。 Filter一般由一个或多个Pin组成，Filter之间通过Pin相互连接，构成一条顺序的链路。Filter根据实现功能的不同大致可分为3类：source filters、transform filters和rendering filters。   Filter是一种Co
编写DirectShow Filters—DirectShow and COM
CP9的专栏
06-02 3518
seeker一、 如何实现IUnknown Microsoft DirectShow基于组件对象模型(COM)。如果你编写自定义filter，你必须把它作为一个COM对象来实现。DirectShow基类提供一个实现此对象的框架。不过使用基类不是必须的，但它能简化开发进度。这篇文章描述一些COM对象的内部实现细节和它们在DirectShow基类的实现。本文假定你知道如何编程COM客户端程序—
DirectShow之filters例程详解前言
bdmrg的专栏
01-10 1917
direcshow filter里程的解读和分析。要开发filter，研读directshow提供的filter例程是最好的方法，该文是对filter的一个简单介绍，随后会对每一个filter例程进行详细的解读
Arduino 例程详细教学29.矩阵键盘
06-30
Arduino 例程详细教学29.矩阵键盘Arduino 例程详细教学29.矩阵键盘Arduino 例程详细教学29.矩阵键盘Arduino 例程详细教学29.矩阵键盘Arduino 例程详细教学29.矩阵键盘Arduino 例程详细教学29.矩阵键盘Arduino 例程...
Arduino 例程详细教学13.温度传感器
06-30
Arduino 例程详细教学13.温度传感器Arduino 例程详细教学13.温度传感器Arduino 例程详细教学13.温度传感器Arduino 例程详细教学13.温度传感器Arduino 例程详细教学13.温度传感器Arduino 例程详细教学13.温度传感器...
Arduino 例程详细教学38.I2C模块 DS1307时钟
06-30
Arduino 例程详细教学38.I2C模块 DS1307时钟Arduino 例程详细教学38.I2C模块 DS1307时钟Arduino 例程详细教学38.I2C模块 DS1307时钟Arduino 例程详细教学38.I2C模块 DS1307时钟Arduino 例程详细教学38.I2C模块 DS...
Arduino 例程详细教学37.土壤湿度传感器程序
06-30
Arduino 例程详细教学37.土壤湿度传感器程序Arduino 例程详细教学37.土壤湿度传感器程序Arduino 例程详细教学37.土壤湿度传感器程序Arduino 例程详细教学37.土壤湿度传感器程序Arduino 例程详细教学37.土壤湿度...
CameraUtil_directshow.rar
08-21
directshow实现摄像头录频压缩（自带压缩与调用x264两种方法） 其中包括设置视频的分辨率，视频的帧数，遍历系统设备，储存graph等方法的简单例子。
DirectShow录屏工具
06-05
用于录制屏幕的工具,本身是一个Directshow的filter，包括ffmpeg工具
directshow filter 工具
04-09
directshow filter完整的包含 了多个标准directshow filter，同时包含directshow filter的查看工具
几个有用的DirectShow Filter
yjh0628的专栏
04-11 997
1. CLSID_InfTee一进多出的filter，把Input Pin传过来的IMediaSample拷贝多份到Output Pin。Output Pin的个数：- 创建时为1- 每连接一个Output Pin，就多出一个新的- 第n个Output Pin的名字为sprintf(szName, "Output%d", n);如果想先搞出n个Output Pin之后慢慢连下层filter，就请参
编写DirectShow Filters—Filter的数据流动
CP9的专栏
05-20 4711
seeker本节详细描述数据如何通过filter graph流动。集中于使用IMemInputPin/IAsyncReader的本地内存传输使用。为编写自定义filter的开发者提供了扩展。大量数据通过一个filter graph移动。粗略可为两类：媒体数据和控制数据。一般来说，媒体数据按downstream顺序传递而控制数据按upstream顺序传递。媒体包括视频帧、音频采样、MPEG包等等来形
编写DirectShow Filters—概述
CP9的专栏
05-16 3241
seeker(一) 介绍DirectShow Filter开发本章提供开发一个自定义DirectShow filter的简单框架描述，也提供了链接到更详细讨论这些任务的主题。在阅读本章之前，阅读在About DirectShow主题，它描述了全面的DirectShow构架。1. DirectShow基类库Directshow sdk包括了编写filters的一组C++类。虽然它们不是必需的，但
DirectShow应用：用程序连接Filters实现媒体播放
softdragon777的专栏
07-07 836
DirectShow应用：用程序连接Filters实现媒体播放   Windows平台下的音视频应用，多以DirectShow为开发工具，通过Graphedit选择合适的Filters并连接成实际的链路，就可以实现简单播放。但在程序中如何实现呢，笔者带着这个问题进行了探索，现将初步成果呈现出来，以期收抛砖引玉之效，共同提高。 一．       枚举Filters Windows系统中的Fi
《微软：DirectShow开发指南》第12章 Writing DirectShow Source Filters
weixin_33896069的博客
08-01 173
Of the three classes of Microsoft DirectShow filters—source, transform, and renderer—the source filter is the one that generates the stream data manipulated by the filter graph. Every filter graph has...
DirectShow体系结构之Filter
冷月醉雪的博客
03-21 447
    Filter是DirectShow最基本的概念。DirectShow使用Filter Graph来管理Filter，Filter Graph是Filter的容器，而Filter是Filter Graph中的最小功能模块。Filter按照功能来分，大致分为三类：Source Filters、Transform Filters和Renderer Filters。Source Filter主要负...
Verilog PLI指南：TF与ACC例程详细解析
这部分文档详细描述了如何通过ACC例程来访问和操作设计中的硬件接口。ACC提供了对硬件寄存器、信号和其他硬件资源的低级别访问，通常用于驱动硬件行为或读取测量数据。 **Using the Verilog PLI** 这部分内容介绍...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值