以位图形式捕获指定开发主机的当前屏幕显示。
语法
HRESULT XtfCaptureScreenshot(
LPCWSTR address,
HBITMAP* phBitmap
)
参数
address
类型：LPCWSTR
指向开发主机的工具 IP 地址或主机名的指针。
phBitmap
类型：HBITMAP*
指向捕获屏幕显示的位图的 HBITMAP 的指针（如果成功）。 使用此位图完毕后，调用 DeleteObject 以释放与 HBITMAP 关联的资源。
返回值
类型：HRESULT
如果成功，则返回 S_OK；否则返回 HRESULT 错误代码。
备注
此函数捕获指定开发主机的屏幕上当前显示内容的位图。 位图包括当前在主机输出上显示的任何内容：独占应用、共享应用、贴靠的应用、系统 UI（如主页或通知弹出窗口）等等。 位图使用当前为主机选择的显示分辨率。
使用 XtfCaptureScreenshot 瞬时控制视频输出流。 这导致显示屏上的瞬时帧速率故障，并且会导致在捕获时 GameDVR 录制的视频中出现黑屏段。
你的代码应遵循建议的编程实践，并使用 phBitmap 中返回的位图中的嵌入信息来确定所得位图的分辨率。 要求所得位图的预期分辨率与当前开发主机的屏幕分辨率匹配。
有关捕获屏幕截图的详细信息，请参阅屏幕捕获工具 (xbcapture.exe)（NDA 主题）要求授权。
要求
头文件：xtfconsolecontrol.h
库：xtfconsolecontrol.lib
支持平台：Windows（适用于 Xbox 主机工具）