Revision control
+ // Copyright (C) 2026 The Qt Company Ltd.
+ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
+ #ifndef QWINDOWSD3D11TEXTUREREADBACK_P_H
+ #define QWINDOWSD3D11TEXTUREREADBACK_P_H
+
+ //
+ // W A R N I N G
+ // -------------
+ //
+ // This file is not part of the Qt API. It exists purely as an
+ // implementation detail. This header file may change from version to
+ // version without notice, or even be removed.
+ //
+ // We mean it.
+ //
+
+ #include <QtMultimedia/qtmultimediaexports.h>
+ #include <QtMultimedia/qabstractvideobuffer.h>
+
+ #include <QtCore/qsize.h>
+ #include <QtCore/private/qcomptr_p.h>
+
+ #include <d3d11.h>
+ #include <d3d11_1.h>
+
+ QT_BEGIN_NAMESPACE
+
+ namespace QtMultimediaPrivate {
+
+ /*! \internal
+ Copies a D3D11 texture into a CPU-accessible staging texture so that its pixels can be
+ read back, e.g. to implement QAbstractVideoBuffer::map() as a fallback when GPU import
+ into the sink's QRhi is unavailable.
+ */
+ class Q_MULTIMEDIA_EXPORT QWindowsD3D11TextureReadback
+ {
+ public:
+ /** Maps 'texture', owned by 'device', for CPU read access. 'frameSize' is the region of
+ * the texture that holds valid frame data. Returns an empty MapData on failure. Must be
+ * paired with a call to unmap(). Only one mapping may be active at a time. */
+ QAbstractVideoBuffer::MapData map(const ComPtr<ID3D11Device> &, const ComPtr<ID3D11Texture2D> &,
+ const QSize &frameSize);
+ void unmap();
+
+ private:
+ ComPtr<ID3D11Texture2D> m_stagingTex;
+ ComPtr<ID3D11DeviceContext> m_stagingCtx;
+ bool m_mapped = false;
+ };
+
+ } // namespace QtMultimediaPrivate
+
+ QT_END_NAMESPACE
+
+ #endif // QWINDOWSD3D11TEXTUREREADBACK_P_H