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 主机工具)另请参阅
XtfConsoleControlXBOX Tools Framework 原生 API 参考
