1 /*
2 * Copyright (c) 2020-2023, Intel Corporation
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice shall be included
12 * in all copies or substantial portions of the Software.
13 *
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
17 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
18 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20 * OTHER DEALINGS IN THE SOFTWARE.
21 */
22 
23 //!
24 //! \file     decode_mem_compression.h
25 //! \brief    Defines the common interface for decode mmc
26 //! \details  The decode media mmc is to handle decode mmc operations
27 //!
28 
29 #ifndef __MEDIA_DECODE_MEM_COMPRESSION_H__
30 #define __MEDIA_DECODE_MEM_COMPRESSION_H__
31 
32 #include "media_mem_compression.h"
33 #include "codec_hw_next.h"
34 
35 class MhwMiInterface;
36 class DecodeMemComp : public MediaMemComp
37 {
38 public:
39     //!
40     //! \brief    Construct
41     //!
42     DecodeMemComp(CodechalHwInterfaceNext *hwInterface, PMOS_INTERFACE osInterface = nullptr);
43 
44     //!
45     //! \brief    Copy constructor
46     //!
47     DecodeMemComp(const DecodeMemComp&) = delete;
48 
49     //!
50     //! \brief    Copy assignment operator
51     //!
52     DecodeMemComp& operator=(const DecodeMemComp&) = delete;
53 
54     //!
55     //! \brief    IsMmcEnabled
56     //!
57     bool IsMmcEnabled();
58 
59     //!
60     //! \brief    Destructor
61     //!
~DecodeMemComp()62     virtual ~DecodeMemComp() {};
63 
64 #if (_DEBUG || _RELEASE_INTERNAL)
65     virtual MOS_STATUS UpdateUserFeatureKey(PMOS_SURFACE surface);
66 
67     MOS_STATUS ReportSurfaceMmcMode(PMOS_SURFACE surface);
68 #endif
69 
70 protected:
71 #if (_DEBUG || _RELEASE_INTERNAL)
72     bool                    m_userFeatureUpdated = false;              //!< Inidate if mmc user feature key for decode is updated
73 
74     uint32_t                m_compressibleId  = 0;
75     uint32_t                m_compressModeId  = 0;
76 #endif
77 
78     void InitDecodeMmc(CodechalHwInterfaceNext *hwInterface);
79 
80     bool m_mmcEnabledForDecode = false;  //!< Indicate if mmc is enabled for decode
81     std::shared_ptr<mhw::mi::Itf> m_miItf; //!< Point to MI interface
82 
83 MEDIA_CLASS_DEFINE_END(DecodeMemComp)
84 };
85 
86 #endif //__MEDIA_DECODE_MEM_COMPRESSION_H__
87