Debian Codegraph @

media_softlet/agnostic/common/media_interfaces/media_interfaces_mhw_next.h

raw
1 /*
2 * Copyright (c) 2021-2022, 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 //! \file media_interfaces_mhw_next.h
24 //! \brief Gen-specific factory creation of the mhw interfaces
25 //!
26
27 #ifndef __MEDIA_INTERFACES_MHW_NEXT_H__
28 #define __MEDIA_INTERFACES_MHW_NEXT_H__
29
30 #include "media_factory.h"
31 #include "igfxfmid.h"
32 #include "mos_utilities.h"
33 #include "mos_os.h"
34 #include "mhw_vdbox_avp_itf.h"
35 #include "mhw_vdbox_vdenc_itf.h"
36 #include "mhw_vdbox_huc_itf.h"
37 #include "mhw_mi_itf.h"
38 #include "mhw_blt_itf.h"
39 #include "mhw_vdbox_hcp_itf.h"
40 #include "mhw_vdbox_mfx_itf.h"
41 #include "mhw_vebox_itf.h"
42 #include "mhw_sfc_itf.h"
43 #include "mhw_render_itf.h"
44 #include "mhw_vdbox_vvcp_itf.h"
45 #include "mhw_vdbox_aqm_itf.h"
46
47 // forward declarations
48 class MhwCpInterface;
49 class MhwSfcInterface;
50 class XMHW_STATE_HEAP_INTERFACE;
51 class MhwVeboxInterface;
52 class MhwVdboxMfxInterface;
53 class MhwVdboxHcpInterface;
54 class MhwVdboxHucInterface;
55 class MhwVdboxVdencInterface;
56 class MhwBltInterface;
57 class MhwVdboxAvpInterface;
58
59 //!
60 //! \class MhwInterfacesNext
61 //! \brief MHW interfacesNext
62 //!
63 class MhwInterfacesNext
64 {
65 public:
66 virtual ~MhwInterfacesNext() {}
67
68 //! \brief Determines which interfaces are created
69 struct CreateParams
70 {
71 CreateParams()
72 {
73 Flags.m_value = 0;
74 }
75
76 union
77 {
78 struct
79 {
80 uint32_t m_render : 1;
81 uint32_t m_sfc : 1;
82 uint32_t m_stateHeap : 1;
83 uint32_t m_vebox : 1;
84 uint32_t m_vdboxAll : 1;
85 uint32_t m_mfx : 1;
86 uint32_t m_hcp : 1;
87 uint32_t m_huc : 1;
88 uint32_t m_vdenc : 1;
89 uint32_t m_blt : 1;
90 uint32_t m_avp : 1;
91 uint32_t m_reserved : 21;
92 };
93 uint32_t m_value;
94 } Flags;
95
96 uint8_t m_heapMode = 0; //!< To be deprecated when heap management unified
97 bool m_isDecode = false; //!< Whether or not decode is in use, only valid for VDBOX creation
98 bool m_isCp = false; //!< Whether or not CP is in use, CP only need mi and cp interface.
99 bool m_isMos = false; //!< Create it for mos, for example hws .
100 };
101
102 /* Below legacy interfaces are kept temporarily for backward compatibility */
103
104 //! \brief These interfaces are responsible for constructing instructions,
105 //! structures, and registers for hardware.
106 MhwCpInterface *m_cpInterface = nullptr;
107 MhwSfcInterface *m_sfcInterface = nullptr;
108 XMHW_STATE_HEAP_INTERFACE *m_stateHeapInterface = nullptr;
109 MhwVeboxInterface *m_veboxInterface = nullptr;
110 MhwBltInterface *m_bltInterface = nullptr;
111 PMOS_INTERFACE m_osInterface = nullptr;
112 /* New mhw sub interfaces*/
113 std::shared_ptr<mhw::vdbox::avp::Itf> m_avpItf = nullptr;
114 std::shared_ptr<mhw::vdbox::vdenc::Itf> m_vdencItf = nullptr;
115 std::shared_ptr<mhw::vdbox::huc::Itf> m_hucItf = nullptr;
116 std::shared_ptr<mhw::mi::Itf> m_miItf = nullptr;
117 std::shared_ptr<mhw::vdbox::hcp::Itf> m_hcpItf = nullptr;
118 std::shared_ptr<mhw::vdbox::mfx::Itf> m_mfxItf = nullptr;
119 std::shared_ptr<mhw::vebox::Itf> m_veboxItf = nullptr;
120 std::shared_ptr<mhw::sfc::Itf> m_sfcItf = nullptr;
121 std::shared_ptr<mhw::blt::Itf> m_bltItf = nullptr;
122 std::shared_ptr<mhw::render::Itf> m_renderItf = nullptr;
123 std::shared_ptr<mhw::vdbox::vvcp::Itf> m_vvcpItf = nullptr;
124 std::shared_ptr<mhw::vdbox::aqm::Itf> m_aqmItf = nullptr;
125
126 //!
127 //! \brief Calls the factory function to initialize all requested interfaces.
128 //! \param [in] params
129 //! Configuration flags for the creation of MHW interfaces.
130 //! \param [in] osInterface
131 //! OS interface
132 //! \return MhwInterfaces*
133 //! returns a valid pointer if successful and nullptr if failed.
134 //!
135 static MhwInterfacesNext* CreateFactory(
136 CreateParams params,
137 PMOS_INTERFACE osInterface);
138
139 //!
140 //! \brief Creates requested MHW interfaces.
141 //! \param [in] params
142 //! Configuration flags for the creation of MHW interfaces.
143 //! \param [in] osInterface
144 //! OS interface
145 //! \return MOS_STATUS_SUCCESS if succeeded, else error code.
146 //!
147 virtual MOS_STATUS Initialize(
148 CreateParams params,
149 PMOS_INTERFACE osInterface) = 0;
150
151 //!
152 //! \brief Destroys all created MHW interfaces
153 //! \details If the HAL creation fails, this is used for cleanup
154 //!
155 virtual void Destroy();
156
157 //!
158 //! \brief Set Interfaces Destroy State
159 //! \details If the interfaces has destroyed, set this state value on
160 //!
161 void SetDestroyState(bool destorystate) { m_isDestroyed = destorystate; };
162 bool GetDestroyState() { return m_isDestroyed; };
163
164 private:
165 bool m_isDestroyed = false;
166 MEDIA_CLASS_DEFINE_END(MhwInterfacesNext)
167 };
168
169 extern template class MediaFactory<uint32_t, MhwInterfacesNext>;
170
171 #endif // __MEDIA_INTERFACES_MHW_NEXT_H__