硬件编解码（五）Intel提供的QuickSync使用样例（2）相关数据结构的介绍

相关的数据结构

编码器的定义

// 编码器
class CEncodingPipeline
{
public:
    CEncodingPipeline();
    virtual ~CEncodingPipeline();

	// 初始化
    virtual mfxStatus Init(sInputParams *pParams);

	// 运行编码器
    virtual mfxStatus Run();

	// 关闭编码器
    virtual void Close();

	// 重置编码组件
    virtual mfxStatus ResetMFXComponents(sInputParams* pParams);

	// 重置驱动
    virtual mfxStatus ResetDevice();

    void SetNumView(mfxU32 numViews) { m_nNumView = numViews; }
    virtual void  PrintInfo();

	// Linux媒体设备相关的设置
    void InitV4L2Pipeline(sInputParams *pParams);
    mfxStatus CaptureStartV4L2Pipeline();
    void CaptureStopV4L2Pipeline();

	// 插入一个IDR帧
    void InsertIDR(bool bIsNextFrameIDR);

#if defined (ENABLE_V4L2_SUPPORT)
    v4l2Device v4l2Pipeline;
    pthread_t m_PollThread;
#endif

protected:
    std::pair<CSmplBitstreamWriter *,CSmplBitstreamWriter *> m_FileWriters;

	// yuv文件读取器
    CSmplYUVReader m_FileReader;

	// 任务池
    CEncTaskPool m_TaskPool;

	// 视频会话
    MFXVideoSession m_mfxSession;

	// 视频编码器
    MFXVideoENCODE* m_pmfxENC;

	// 视频预处理器
    MFXVideoVPP* m_pmfxVPP;

	// 编码器参数
    mfxVideoParam m_mfxEncParams;

	// 视频预处理器参数
    mfxVideoParam m_mfxVppParams;

	// 3D编码， MVC (Multi-View Video Coding) 
    mfxU16 m_MVCflags; // MVC codec is in use

    mfxU32 m_InputFourCC;

	// 用户模块
    std::auto_ptr<MFXVideoUSER> m_pUserModule;

	// 插件
    std::auto_ptr<MFXPlugin> m_pPlugin;

	// 内存分配器
    MFXFrameAllocator* m_pMFXAllocator;

	// 内存分配器的参数
    mfxAllocatorParams* m_pmfxAllocatorParams;
    MemType m_memType;
    mfxU16 m_nMemBuffer;
    bool m_bExternalAlloc; // use memory allocator as external for Media SDK


	// 编码器的输入队列（同时也是视频预处理器的输出队列）
    mfxFrameSurface1* m_pEncSurfaces; // frames array for encoder input (vpp output)

	// 视频预处理器的输入队列
    mfxFrameSurface1* m_pVppSurfaces; // frames array for vpp input

	// 内存分配请求的回应
    mfxFrameAllocResponse m_EncResponse;  // memory allocation response for encoder
    mfxFrameAllocResponse m_VppResponse;  // memory allocation response for vpp

    mfxU32 m_nNumView;
    mfxU32 m_nFramesToProcess; // number of frames to process

    // for disabling VPP algorithms
	// 用于禁用vpp算法
    mfxExtVPPDoNotUse m_VppDoNotUse;
    // for MVC encoder and VPP configuration
    mfxExtMVCSeqDesc m_MVCSeqDesc;
	// 编码选项
    mfxExtCodingOption m_CodingOption;
    // for look ahead BRC configuration
    mfxExtCodingOption2 m_CodingOption2;
    // HEVC
	// HEVC的参数
    mfxExtHEVCParam m_ExtHEVCParam;
    mfxExtCodingOption3 m_CodingOption3;

    // external parameters for each component are stored in a vector
	// 额外的一些参数
    std::vector<mfxExtBuffer*> m_VppExtParams;
    std::vector<mfxExtBuffer*> m_EncExtParams;

	// 设备
    CHWDevice *m_hwdev;

    bool isV4L2InputEnabled;

    mfxU32 m_nTimeout;

    bool   m_bFileWriterReset;
    mfxU32 m_nFramesRead;
    bool   m_bCutOutput;
    bool   m_bInsertIDR;
    bool   m_bTimeOutExceed;

	// 编码控制对象
    mfxEncodeCtrl m_encCtrl;

	// 时间统计信息
    CTimeStatisticsReal m_statOverall;
    CTimeStatisticsReal m_statFile;

	// 初始化编码器参数
    virtual mfxStatus InitMfxEncParams(sInputParams *pParams);

	// 初始化vpp（视频预处理）参数
    virtual mfxStatus InitMfxVppParams(sInputParams *pParams);

    virtual mfxStatus InitFileWriters(sInputParams *pParams);
    virtual void FreeFileWriters();
    virtual mfxStatus InitFileWriter(CSmplBitstreamWriter **ppWriter, const msdk_char *filename);

    virtual mfxStatus AllocAndInitVppDoNotUse();
    virtual void FreeVppDoNotUse();

    virtual mfxStatus AllocAndInitMVCSeqDesc();
    virtual void FreeMVCSeqDesc();

    virtual mfxStatus CreateAllocator();
    virtual void DeleteAllocator();

    virtual mfxStatus CreateHWDevice();
    virtual void DeleteHWDevice();

    virtual mfxStatus AllocFrames();
    virtual void DeleteFrames();

    virtual mfxStatus AllocateSufficientBuffer(mfxBitstream* pBS);
    virtual mfxStatus FillBuffers();
    virtual mfxStatus LoadNextFrame(mfxFrameSurface1* pSurf);

	// 获取一个空闲的任务
    virtual mfxStatus GetFreeTask(sTask **ppTask);

	// 返回视频会话
    virtual MFXVideoSession& GetFirstSession(){return m_mfxSession;}

	// 返回视频编码器
    virtual MFXVideoENCODE* GetFirstEncoder(){return m_pmfxENC;}
};

编码任务

定义任务结构体的目的是方便编码器使用多线程

// 任务
struct sTask
{
	// 比特流
    mfxBitstream mfxBS;
	// 编码同步点
    mfxSyncPoint EncSyncP;

	// 依赖的编码同步点，vpp是指vedio preprocessing
    std::list<mfxSyncPoint> DependentVppTasks;

	// 比特流写入助手
    CSmplBitstreamWriter *pWriter;

    sTask();
    mfxStatus WriteBitstream();
    mfxStatus Reset();
    mfxStatus Init(mfxU32 nBufferSize, CSmplBitstreamWriter *pWriter = NULL);
    mfxStatus Close();
};

编码任务池

// 编码任务池
class CEncTaskPool
{
public:
    CEncTaskPool();
    virtual ~CEncTaskPool();

    virtual mfxStatus Init(MFXVideoSession* pmfxSession, CSmplBitstreamWriter* pWriter, mfxU32 nPoolSize, mfxU32 nBufferSize, CSmplBitstreamWriter *pOtherWriter = NULL);
    virtual mfxStatus GetFreeTask(sTask **ppTask);

	// 同步第一个任务
    virtual mfxStatus SynchronizeFirstTask();

    virtual CTimeStatistics& GetOverallStatistics() { return m_statOverall;}
    virtual CTimeStatistics& GetFileStatistics() { return m_statFile;}
    virtual void Close();
protected:
    sTask* m_pTasks;
    mfxU32 m_nPoolSize;
    mfxU32 m_nTaskBufferStart;

	// 视频会话
    MFXVideoSession* m_pmfxSession;

	// 时间统计信息
    CTimeStatistics m_statOverall;
    CTimeStatistics m_statFile;

	// 返回一个空闲任务的编号
    virtual mfxU32 GetFreeTaskIndex();
};