Desktop Duplication API(桌面拷贝API)

最新推荐文章于 2024-06-18 23:54:30 发布
最新推荐文章于 2024-06-18 23:54:30 发布
阅读量1.6w 收藏 13
点赞数 1
分类专栏： VC++ 文章标签： directx11 操作系统 api desktop gpu

原文https://msdn.microsoft.com/en-us/library/windows/desktop/hh404487(v=vs.85).aspx


win8放弃了标准的win2k显示驱动模块（XDDM），也就是镜像驱动，并提供桌面拷贝API来替代它。The desktop duplication API 提供远程接口操作一组桌面截图的协作方案。应用可以使用the desktop duplication API 来一帧一帧更新桌面。因为应用收到更新的桌面截图来自与DXGI接口，所以该应用可以完全使用GPU来完成图片的更新。


更新桌面图片数据
旋转桌面图片
更新桌面指针
相关话题

1)更新桌面图片数据


DXGL提供一种包含当前桌面图片的接口，通过新的 IDXGIOutputDuplication::AcquireNextFrame 方法。格式化桌面图片永远是DXGI_FORMAT_B8G8R8A8_UNORM，不管当前显示模式是什么。通过这个接口，那些IDXGIOutputDuplication 方法返回指定类型的信息来帮助你决定哪些像素你需要去处理。
• IDXGIOutputDuplication::GetFrameDirtyRects 返回的是“脏”的区域，没有重叠的一组组矩形区域就是自从你要求提供桌面图片后操作系统更新过的区域，
IDXGIOutputDuplication::GetFrameMoveRects  返回的是移动的区域， 操作系统将有着一组一模一样的矩形区域的像素的桌面截图移动到到另一个位置。每个移动的区域包含一个目标矩形和一个源点。源点指定从操作系统复制该区域的位置和目标矩形指定操作系统移动该区域的位置。移动区域不能被拉伸，所以源和目标的尺寸一直都是相同的。


支持桌面图片通过低速的连接传到你远程客户端中。一定数量的数据被传输到指定连接对象用来接收仅仅是图片数据，指定你的客户端程序移动区域，而不是实际像素数据。为了实现这个移动，你的客户程序必须存储上一张完成好的桌面图片。
当操作系统积累了许多未处理的桌面图片，它就会用光用来准确移动区域的存储空间，在这种情况下，操作系统开始将积累已存在更新覆盖掉刚刚更新的图片。结果导致操作系统实际不是按帧更新的而是按像素点。但是这种情况不会导致客户端的显示问题，因为你收到的是一整张的桌面图片而不仅仅是更新的像素点。
为了重建正确的桌面图片，你的客户端第一次必须处理所有的移动区域，然后再处理所有的脏的区域。两种区域的列表应该完全的清空。这个示例取自 Desktop Duplication Sample 展示了怎么样处理两种区域在同一帧中。

//
// Get next frame and write it into Data
//
HRESULT DUPLICATIONMANAGER::GetFrame(_Out_ FRAME_DATA* Data)
{
    HRESULT hr = S_OK;

    IDXGIResource* DesktopResource = NULL;
    DXGI_OUTDUPL_FRAME_INFO FrameInfo;

    //Get new frame
    hr = DeskDupl->AcquireNextFrame(500, &FrameInfo, &DesktopResource);
    if (FAILED(hr))
    {
        if ((hr != DXGI_ERROR_ACCESS_LOST) && (hr != DXGI_ERROR_WAIT_TIMEOUT))
        {
            DisplayErr(L"Failed to acquire next frame in DUPLICATIONMANAGER", L"Error", hr);
        }
        return hr;
    }

    // If still holding old frame, destroy it
    if (AcquiredDesktopImage)
    {
        AcquiredDesktopImage->Release();
        AcquiredDesktopImage = NULL;
    }

    // QI for IDXGIResource
    hr = DesktopResource->QueryInterface(__uuidof(ID3D11Texture2D), reinterpret_cast<void **>(&AcquiredDesktopImage));
    DesktopResource->Release();
    DesktopResource = NULL;
    if (FAILED(hr))
    {
        DisplayErr(L"Failed to QI for ID3D11Texture2D from acquired IDXGIResource in DUPLICATIONMANAGER", L"Error", hr);
        return hr;
    }

    // Get metadata
    if (FrameInfo.TotalMetadataBufferSize)
    {
        // Old buffer too small
        if (FrameInfo.TotalMetadataBufferSize > MetaDataSize)
        {
            if (MetaDataBuffer)
            {
                delete [] MetaDataBuffer;
                MetaDataBuffer = NULL;
            }
            MetaDataBuffer = new (std::nothrow) BYTE[FrameInfo.TotalMetadataBufferSize];
            if (!MetaDataBuffer)
            {
                DisplayErr(L"Failed to allocate memory for metadata in DUPLICATIONMANAGER", L"Error", E_OUTOFMEMORY);
                MetaDataSize = 0;
                Data->MoveCount = 0;
                Data->DirtyCount = 0;
                return E_OUTOFMEMORY;
            }
            MetaDataSize = FrameInfo.TotalMetadataBufferSize;
        }

        UINT BufSize = FrameInfo.TotalMetadataBufferSize;

        // Get move rectangles
        hr = DeskDupl->GetFrameMoveRects(BufSize, reinterpret_cast<DXGI_OUTDUPL_MOVE_RECT*>(MetaDataBuffer), &BufSize);
        if (FAILED(hr))
        {
            if (hr != DXGI_ERROR_ACCESS_LOST)
            {
                DisplayErr(L"Failed to get frame move rects in DUPLICATIONMANAGER", L"Error", hr);
            }
            Data->MoveCount = 0;
            Data->DirtyCount = 0;
            return hr;
        }
        Data->MoveCount = BufSize / sizeof(DXGI_OUTDUPL_MOVE_RECT);

        BYTE* DirtyRects = MetaDataBuffer + BufSize;
        BufSize = FrameInfo.TotalMetadataBufferSize - BufSize;

        // Get dirty rectangles
        hr = DeskDupl->GetFrameDirtyRects(BufSize, reinterpret_cast<RECT*>(DirtyRects), &BufSize);
        if (FAILED(hr))
        {
            if (hr != DXGI_ERROR_ACCESS_LOST)
            {
                DisplayErr(L"Failed to get frame dirty rects in DUPLICATIONMANAGER", L"Error", hr);
            }
            Data->MoveCount = 0;
            Data->DirtyCount = 0;
            return hr;
        }
        Data->DirtyCount = BufSize / sizeof(RECT);

        Data->MetaData = MetaDataBuffer;
    }

    Data->Frame = AcquiredDesktopImage;
    Data->FrameInfo = FrameInfo;

    return hr;
}

//
// Release frame
//
HRESULT DUPLICATIONMANAGER::DoneWithFrame()
{
    HRESULT hr = S_OK;

    hr = DeskDupl->ReleaseFrame();
    if (FAILED(hr))
    {
        DisplayErr(L"Failed to release frame in DUPLICATIONMANAGER", L"Error", hr);
        return hr;
    }

    if (AcquiredDesktopImage)
    {
        AcquiredDesktopImage->Release();
        AcquiredDesktopImage = NULL;
    }

    return hr;
}

2）旋转桌面图片
您必须向桌面复制客户端应用程序添加显式代码以支持旋转模式。在旋转模式下，从IDXGIOutputDuplication :: AcquireNextFrame接收的表面始终处于未旋转方向，桌面图像在这个表面内旋转。 例如，如果桌面在90度旋转时设置为768x1024，则AcquireNextFrame返回一个1024x768表面，桌面图像在其中旋转。 这里有一些旋转示例。
桌面复制客户端应用程序中的代码必须在显示桌面映像之前正确旋转桌面映像。
注意在多监视器方案中，您可以单独旋转每个监视器的桌面图像。
3）更新桌面光标
你需要用 desktop duplication API 来指定你是否需要把鼠标指定加到桌面图片。IDXGIOutputDuplication::AcquireNextFrame 可以提供有或者无鼠标光标的桌面图片。如果桌面被画上鼠标光标，那么光标的位置数据要被指派到AcquireNextFrame（在PointerPosition成员中DXGI_OUTDUPL_FRAME_INFO 的pFrameInfo 参数）报告分离的光标使其不可见。如果图形适配器将鼠标指针叠加在桌面图像的顶部，AcquireNextFrame报告单独的指针是可见的。因此，您的客户端应用程序必须将鼠标指针形状绘制到桌面图像上，以准确表示当前用户在其显示器上将看到的内容。

要绘制桌面的鼠标指针，请使用AcquireNextFrame的pFrameInfo参数中的DXGI_OUTDUPL_FRAME_INFO的PointerPosition成员来确定在桌面图像上的鼠标指针左上角的位置。 绘制第一帧时，必须使用IDXGIOutputDuplication :: GetFramePointerShape方法来获取有关鼠标指针形状的信息。 每次调用AcquireNextFrame以获得下一帧也提供该帧的当前指针位置。 另一方面，只有当形状改变时，您才需要再次使用GetFramePointerShape。 所以，保留最后一个指针图像的副本，并使用它来绘制桌面上，除非鼠标指针的形状更改。
注意：与指针形状图像一起，GetFramePointerShape提供热点位置的大小。 热点仅供参考。 指针图像的绘制位置与热点无关。

//
// Retrieves mouse info and write it into PtrInfo
//
HRESULT DUPLICATIONMANAGER::GetMouse(_Out_ PTR_INFO* PtrInfo, _In_ DXGI_OUTDUPL_FRAME_INFO* FrameInfo, INT OffsetX, INT OffsetY)
{
    HRESULT hr = S_OK;

    // A non-zero mouse update timestamp indicates that there is a mouse position update and optionally a shape change
    if (FrameInfo->LastMouseUpdateTime.QuadPart == 0)
    {
        return hr;
    }

    bool UpdatePosition = true;

    // Make sure we don't update pointer position wrongly
    // If pointer is invisible, make sure we did not get an update from another output that the last time that said pointer
    // was visible, if so, don't set it to invisible or update.
    if (!FrameInfo->PointerPosition.Visible && (PtrInfo->WhoUpdatedPositionLast != OutputNumber))
    {
        UpdatePosition = false;
    }

    // If two outputs both say they have a visible, only update if new update has newer timestamp
    if (FrameInfo->PointerPosition.Visible && PtrInfo->Visible && (PtrInfo->WhoUpdatedPositionLast != OutputNumber) && (PtrInfo->LastTimeStamp.QuadPart > FrameInfo->LastMouseUpdateTime.QuadPart))
    {
        UpdatePosition = false;
    }

    // Update position
    if (UpdatePosition)
    {
        PtrInfo->Position.x = FrameInfo->PointerPosition.Position.x + OutputDesc.DesktopCoordinates.left - OffsetX;
        PtrInfo->Position.y = FrameInfo->PointerPosition.Position.y + OutputDesc.DesktopCoordinates.top - OffsetY;
        PtrInfo->WhoUpdatedPositionLast = OutputNumber;
        PtrInfo->LastTimeStamp = FrameInfo->LastMouseUpdateTime;
        PtrInfo->Visible = FrameInfo->PointerPosition.Visible != 0;
    }

    // No new shape
    if (FrameInfo->PointerShapeBufferSize == 0)
    {
        return hr;
    }

    // Old buffer too small
    if (FrameInfo->PointerShapeBufferSize > PtrInfo->BufferSize)
    {
        if (PtrInfo->PtrShapeBuffer)
        {
            delete [] PtrInfo->PtrShapeBuffer;
            PtrInfo->PtrShapeBuffer = NULL;
        }
        PtrInfo->PtrShapeBuffer = new (std::nothrow) BYTE[FrameInfo->PointerShapeBufferSize];
        if (!PtrInfo->PtrShapeBuffer)
        {
            DisplayErr(L"Failed to allocate memory for pointer shape in DUPLICATIONMANAGER", L"Error", E_OUTOFMEMORY);
            PtrInfo->BufferSize = 0;
            return E_OUTOFMEMORY;
        }

        // Update buffer size
        PtrInfo->BufferSize = FrameInfo->PointerShapeBufferSize;
    }

    UINT BufferSizeRequired;
    // Get shape
    hr = DeskDupl->GetFramePointerShape(FrameInfo->PointerShapeBufferSize, reinterpret_cast<VOID*>(PtrInfo->PtrShapeBuffer), &BufferSizeRequired, &(PtrInfo->ShapeInfo));
    if (FAILED(hr))
    {
        if (hr != DXGI_ERROR_ACCESS_LOST)
        {
            DisplayErr(L"Failed to get frame pointer shape in DUPLICATIONMANAGER", L"Error", hr);
        }
        delete [] PtrInfo->PtrShapeBuffer;
        PtrInfo->PtrShapeBuffer = NULL;
        PtrInfo->BufferSize = 0;
        return hr;
    }

    return hr;
}

4）相关话题
DXGI 1.2 Improvements 

qwerty448
关注
专栏目录
对DXGI desktop duplication sample分析，改到MFC上
qwerty448的博客
11-05 7980
desktop duplication是一组WIN8以后才有的桌面截图的协作方案。功能在我看来就是截取桌面屏幕，微软给的示例要命，代码里面老喜欢判断返回值，写个程序贼稳，一来一回代码量就多了，一点不像是示例。再加上里面有各种各样的类、方法和多线程编程。让我一开始拿来的时候是懵笔的，本想直接取里面的函数实现功能而已，发现不是特别好分开，现在终于是搞清楚大概的结构了，本文只讲结构,不讲具体怎么实现的，
DXGI desktop duplication sample.rar
07-09
在本示例中，我们将探讨如何利用DXGI桌面复制API来捕获和分析桌面内容。 1. DXGI桌面复制API：这是DirectX 11引入的一个功能，允许应用程序高效地获取桌面图像的副本，而不会引起屏幕闪烁或影响其他正在运行的应用...
cpp-uDesktopDuplication是一个Unityasset使用DesktopDuplicationAPI来实时截屏作为Texture2D
08-16
uDesktopDuplication是一个Unity asset使用Desktop Duplication API来实时截屏作为Texture2D。(只支持Windows 8/10)
desktop duplication for MFC demo
11-06
把MSDN上的DXGI desktop duplication sample进行改造到MFC上的演示DEMO，有关文章链接 http://blog.csdn.net/qwerty448/article/details/53046195
uDesktopDuplication：Unity的桌面复制API实现（仅适用于Windows 810）
02-06
uDesktopDuplication uDesktopDuplication是Unity资产，可使用Desktop Duplication API将实时屏幕截图用作Texture2D 。 屏幕截图 环境 Windows 8/10 Unity 5 安装 请从下载最新的uDesktopDuplication.unitypackage 。 用法 将uDesktopDuplication/Texture组件附加到目标对象，然后将其主要纹理替换为捕获的屏幕。 请查看示例场景以获取更多详细信息。 执照 MIT许可证（MIT） 版权所有（c）2016 hecomi 特此免费授予获得该软件和相关文档
node-win-desktop-duplication:使用Windows桌面复制API捕获屏幕的库
05-27
Windows桌面节点复制 使用本机插件，它是Windows 8及更高版本的一部分。 安装 npm install windows-desktop-duplication 用法 const { DesktopDuplication } = require ( 'windows-desktop-duplication' ) ; let dd = new DesktopDuplication ( 0 ) ; // register for screen 0 let frame ; try { dd . initialize ( ) ; frame = dd . getFrame ( ) ; } catch ( err ) { console . log ( "An error occured:" , err . message ) ; process . exit ( 0 ) ;
推荐开源项目：uDesktopDuplication - 实时屏幕捕捉的Unity资产库
gitblog_00040的博客
05-20 367
推荐开源项目：uDesktopDuplication - 实时屏幕捕捉的Unity资产库 uDesktopDuplicationDesktop Duplication API implementation for Unity (only for Windows 8/10)项目地址:https://gitcode.com/gh_mirrors/ud/uDesktopDuplication 1、项目...
opecv创建desktop duplication失败
04-30
OpenCV中的Desktop Duplication是一个用于Windows操作系统的API，它用于实时捕获桌面中的图像。如果创建Desktop Duplication失败，可能是由于以下原因： 1. 没有管理员权限：在Windows操作系统中，Desktop ...
VbVncServer:使用DXGI桌面复制的VB6中的简单VNC服务器
03-30
它利用了DirectX 11的Desktop Duplication API来实现桌面共享功能，使远程用户能够实时查看和控制主机的桌面。 【描述详解】 该描述指出，VbVncServer是一个使用VB6编程语言开发的VNC服务器应用。VNC技术是一种远程...
desktop-duplication-cpp:Windows桌面复制工具，用于C ++ 2a中的实时编码演示
05-16
Windows桌面复制工具 这是在演示文稿中进行实时编码的漂亮工具。 您在主屏幕上有IDE和私人注释。 该工具仅捕获此屏幕的代码部分，并在演示文稿监视器或投影仪上全屏显示。 我个人使用此工具来主持C用户组会议，客户会议和专业C培训。 特征 主屏幕的左上方部分被复制到同一屏幕右侧的窗口中。 互动方式： 将窗口移到需要的地方。 投影仪用于实时编码和演示。 鼠标左键双击可使窗口最大化。 现在整个屏幕都在镜像（无窗口框架） 我们阻止Windows在此演示模式下进入睡眠模式 缩放也会更改捕获的区域。 Ctrl +鼠标滚轮 :up-down_arrow: / + / -允许您缩放 Ctrl Shift +鼠标滚轮 :up-down_arrow: 放大较小的步骤 Ctrl + 0将缩放重置为1：1 移动捕获的区域。 Shift +鼠标左键+拖动⇔⇕可移动可见部分 Shift + ← / ↑ / → / ↓将镜像图像对准边框 将窗口移到捕获
desktop demo
03-05
博文链接：https://xl801026.iteye.com/blog/139409
DXGI快速抓屏demo，比gdi高效
01-24
DXGI快速抓屏demo，比gdi高效
windows平台抓屏源代码
07-25
镜像驱动没有提供源代码，但是可以安装运行，64位驱动需要签名才能安装。 xdisp_virt.cpp和.h 文件实现了三种抓屏源代码， GDI抓屏没有实现鼠标绘制，若你有兴趣可自行扩展。 代码提供了JPEG流方式在浏览器中显示远程桌面。 启动xdisp_virt.exe之后，在浏览器（firefox，chrome）中输入 http://IP:8000, 就能看到程序运行机器的桌面效果。 相关博客查看 http://blog.csdn.net/fanxiushu/article/details/76039801 等连接。
FSCapture(抓屏、截图）
07-15
Please read the following terms and conditions carefully before using FastStone Capture. Use of this software indicates you accept the terms of this license agreement and warranty.
C# 拷贝桌面
牛宝宝的专栏
03-11 165
zai'mo public System.Drawing.Bitmap CaptureWindow(IntPtr dest) { IntPtr hdcSrc = User32.GetWindowDC(User32.GetDesktopWindow()); IntPtr hdcDest = GDI32.CreateCompatibleDC(dest); using (Graphics grDest .
c++ Dxgi+FFmpeg 完成对截图屏幕，以及将屏幕数据保存为MP4格式，以完成录屏功能
weixin_43174052的博客
04-18 3910
c++ Dxgi+FFmpeg 完成对截图屏幕，以及将屏幕数据保存为MP4格式，以完成录屏功能
FFMPEG录屏（12）---- DXGI 捕获桌面
06-02 7793
最近增加了对Duplication API捕获桌面的支持，记录一下过程和其中遇到的问题。 参考资料 Desktop Duplication Api AccquireNextFrame DXGI_OUTDUPL_POINTER_SHAPE_TYPE 官方Demo 吐槽 DX这套接口是真的烦，真的烦，为了获取到duplication接口，你得初始化一堆东西啊啊啊啊啊啊啊！初始化的你眼花缭乱啊啊啊啊啊啊啊啊！ 准备工作 避免系统中没有d3d依赖，所有d3d接口通过动态加载方式引入程序。准备一个简单的函数用来加载动
Windows桌面实现之八（DirectX HOOK 方式截取特殊的全屏程序之二）
热门推荐
fanxiushu的专栏
04-21 1万+
by fanxiushu 2019-04-18 转载或引用请注明原始作者。 接上文。 WIN7以上系统WDDM虚拟显卡开发（WDDM Filter/Hook Driver 显卡过滤驱动开发之一） 这篇文章，曾经提到过： windows的应用程序中，绘图的基础图形库包括...
【cv】获取windows窗口图像api
最新发布
xudawu201的博客
06-18 293
速度相对适中，对于非DirectX应用，它能提供稳定的性能，但可能受限于系统和图形驱动的性能。对于快速变化或重负载的图形内容（如游戏），性能可能不佳，因为它依赖于GDI，后者可能无法直接访问GPU加速的渲染内容。由于它直接访问GPU内存，避免了CPU-GPU之间的数据复制，因此可以实现更低的延迟和更高的捕获速率，适合需要高性能屏幕捕获的场景。它能够很好地处理DirectX内容，具有较低的延迟和较高的帧率，适合现代高性能应用的屏幕捕获需求，速度表现优异。获取windows窗口图像api。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值