Skip to main content

XtfCaptureScreenshot

将指定开发主机的当前屏幕显示捕获为位图。

语法

参数

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 主机工具)

另请参阅

XtfConsoleControl
XBOX Tools Framework 原生 API 参考
最后修改于 2026年8月24日