/* * Copyright (c) 2021, Intel Corporation * * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the "Software"), * to deal in the Software without restriction, including without limitation * the rights to use, copy, modify, merge, publish, distribute, sublicense, * and/or sell copies of the Software, and to permit persons to whom the * Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included * in all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR * OTHER DEALINGS IN THE SOFTWARE. */ //! //! \file media_scalability_singlepipe_next.h //! \brief Defines the common interface for media scalability singlepipe mode. //! \details The media scalability singlepipe interface is further sub-divided by component, //! this file is for the base interface which is shared by all components. //! #ifndef __MEDIA_SCALABILITY_SINGLEPIPE_NEXT_H__ #define __MEDIA_SCALABILITY_SINGLEPIPE_NEXT_H__ #include #include "mos_os_specific.h" #include "mos_defs.h" #include "mos_os.h" #include "media_scalability.h" class MediaContext; class MediaScalabilityOption; class MediaScalabilitySinglePipeNext: public MediaScalability { public: //! //! \brief Media scalability singlepipe constructor //! \param [in] hwInterface //! Pointer to HwInterface //! \param [in] componentType //! Component type //! MediaScalabilitySinglePipeNext(void *hwInterface, MediaContext *mediaContext, uint8_t componentType); //! //! \brief Media scalability singlepipe destructor //! virtual ~MediaScalabilitySinglePipeNext(){}; //! //! \brief Copy constructor //! MediaScalabilitySinglePipeNext(const MediaScalabilitySinglePipeNext&) = delete; //! //! \brief Copy assignment operator //! MediaScalabilitySinglePipeNext& operator=(const MediaScalabilitySinglePipeNext&) = delete; //! //! \brief Initialize the media single pipe scalability //! \details It will prepare the resources needed in scalability //! and initialize the state of scalability //! \param [in] option //! Input scalability option //! \return MOS_STATUS //! MOS_STATUS_SUCCESS if success, else fail reason //! virtual MOS_STATUS Initialize(const MediaScalabilityOption &option) override; //! //! \brief Construct parameters for GPU context create. //! \param [in, out] gpuCtxCreateOption //! Pointer to the GPU Context Create Option //! \return MOS_STATUS //! MOS_STATUS_SUCCESS if success, else fail reason //! virtual MOS_STATUS GetGpuCtxCreationOption(MOS_GPUCTX_CREATOPTIONS *gpuCtxCreateOption) override; //! //! \brief Destroy the media scalability //! \return MOS_STATUS //! MOS_STATUS_SUCCESS if success, else fail reason //! virtual MOS_STATUS Destroy() override; //! //! \brief Update the media scalability singlepipe mode state //! \param [in] statePars //! parameters to update the state //! \return MOS_STATUS //! MOS_STATUS_SUCCESS if success, else fail reason //! virtual MOS_STATUS UpdateState(void *statePars) override { return MOS_STATUS_SUCCESS; } //! //! \brief Verify command buffer //! \param [in] requestedSize //! requested size for command buffer //! \param [in] requestedPatchListSize //! requested size for patched list //! \param [out] singleTaskPhaseSupportedInPak //! Inidcate if to use single task phase in pak. //! \return MOS_STATUS //! MOS_STATUS_SUCCESS if success, else fail reason //! virtual MOS_STATUS VerifyCmdBuffer(uint32_t requestedSize, uint32_t requestedPatchListSize, bool &singleTaskPhaseSupportedInPak) override; //! //! \brief Get command buffer //! \param [in, out] cmdBuffer //! Pointer to command buffer //! \return MOS_STATUS //! MOS_STATUS_SUCCESS if success, else fail reason //! virtual MOS_STATUS GetCmdBuffer(PMOS_COMMAND_BUFFER cmdBuffer, bool frameTrackingRequested = true) override; //! //! \brief Return command buffer //! \param [in, out] cmdBuffer //! Pointer to command buffer //! \return MOS_STATUS //! MOS_STATUS_SUCCESS if success, else fail reason //! virtual MOS_STATUS ReturnCmdBuffer(PMOS_COMMAND_BUFFER cmdBuffer) override; //! //! \brief Submit command buffer //! \param [in, out] cmdBuffer //! Pointer to command buffer //! \return MOS_STATUS //! MOS_STATUS_SUCCESS if success, else fail reason //! virtual MOS_STATUS SubmitCmdBuffer(PMOS_COMMAND_BUFFER cmdBuffer) override; //! //! \brief Add synchronization for pipes. //! \param [in] syncType //! type of pipe sync //! \param [in] semaphoreId //! Id of the semaphore used for this sync //! \param [in, out] cmdBuffer //! Pointer to command buffer //! \return MOS_STATUS //! MOS_STATUS_SUCCESS if success, else fail reason //! virtual MOS_STATUS SyncPipe(uint32_t syncType, uint32_t semaphoreId, PMOS_COMMAND_BUFFER cmdBuffer) override { return MOS_STATUS_SUCCESS;}; //! //! \brief Reset semaphore //! \param [in] syncType //! type of pipe sync //! \param [in] semaphoreId //! Id of the semaphore used for this sync //! \param [in, out] cmdBuffer //! Pointer to command buffer //! \return MOS_STATUS //! MOS_STATUS_SUCCESS if success, else fail reason //! virtual MOS_STATUS ResetSemaphore(uint32_t syncType, uint32_t semaphoreId, PMOS_COMMAND_BUFFER cmdBuffer) override { return MOS_STATUS_SUCCESS;}; //! //! \brief Set hint parameters //! \return MOS_STATUS //! MOS_STATUS_SUCCESS if success, else fail reason //! virtual MOS_STATUS SetHintParams(); //! //! \brief Populate hint parameters //! \param [in] cmdBuffer //! Pointer to command buffer //! \return MOS_STATUS //! MOS_STATUS_SUCCESS if success, else fail reason //! MOS_STATUS PopulateHintParams(PMOS_COMMAND_BUFFER cmdBuffer); MEDIA_CLASS_DEFINE_END(MediaScalabilitySinglePipeNext) }; #endif // !__MEDIA_SCALABILITY_SINGLEPIPE_H__