XAppCaptureTakeDiagnosticScreenshot

从应用截取一张诊断屏幕截图。

Syntax

HRESULT XAppCaptureTakeDiagnosticScreenshot(  
         bool gamescreenOnly,  
         XAppCaptureScreenshotFormatFlag captureFlags,  
         const char* filenamePrefix,  
         XAppCaptureDiagnosticScreenshotResult* result  
)  

Parameters

gamescreenOnly   _In_
类型：bool 决定是否只捕获游戏画面。如果设置为 false，除了游戏画面外，可能还会捕获某些 UI，如屏幕键盘。 captureFlags   _In_
类型：XAppCaptureScreenshotFormatFlag 决定捕获将采用 SDR 还是 HDR。 filenamePrefix   _In_opt_
类型：char* 文件名的所需前缀，可选，将附加到诊断文件名的开头。 result   _Out_
类型：XAppCaptureDiagnosticScreenshotResult* 生成的已捕获屏幕截图。

Return value

类型：HRESULT 函数结果。

Remarks

此函数在时间敏感线程上调用不安全。有关详细信息，请参阅时间敏感线程。

与 XAppCaptureTakeScreenshot 不同，调用此函数不会触发 UI 通知。XAppCaptureTakeDiagnosticScreenshot 使用 XAppCaptureScreenshotFormatFlag 来指定屏幕捕获将采用 SDR、HDR 还是两者。但是，仍必须以 HDR 运行才能进行 HDR 捕获。屏幕截图保存到游戏可访问的分区。XAppCaptureDiagnosticScreenshotResult 包含一个 XAppCaptureScreenshotFile 数组，每个结构体都包含一个屏幕截图的文件路径。此函数仅在开发工具包中可用。在零售工具包上，此 API 会立即返回错误。

Requirements

头文件： XAppCapture.h 库： xgameruntime.lib 受支持的平台： Windows、XBOX One 系列主机和 XBOX Series 主机

Conceptual documentation

时间敏感线程

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XAppCaptureTakeDiagnosticScreenshot

XAppCaptureTakeDiagnosticScreenshot

Syntax

Parameters

Return value

Remarks

Requirements

Conceptual documentation

See also

​XAppCaptureTakeDiagnosticScreenshot

​Syntax

​Parameters

​Return value

​Remarks

​Requirements

​Conceptual documentation

​See also

XAppCaptureTakeDiagnosticScreenshot

Syntax

Parameters

Return value

Remarks

Requirements

Conceptual documentation

See also