qwindowsd3d11texturereadback_p.h

Enable keyboard shortcuts

// 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