Skip to main content

XAppCaptureTakeScreenshot

スクリーンショットを取得します。

Syntax

Parameters

requestingUser   _In_
型: XUserHandle
スクリーンショットを要求しているユーザーを表すハンドル。 result   _Out_
型: XAppCaptureTakeScreenshotResult*
返されたスクリーンショットの結果。

Return value

型: HRESULT 関数の結果。

Remarks

この関数は、タイム センシティブ スレッドから呼び出しても安全ではありません。詳細については、Time-sensitive threads を参照してください。
[!NOTE] この関数は XBOX Game Streaming ではサポートされていません。サポートされているプラットフォームについては、以下の Requirements セクションを参照してください。
[!NOTE] 新しいスクリーンショット用のスペースを確保するために、割り当てられた容量がいっぱいになると、古いスクリーンショットは削除されます。一定期間スクリーンショットを保持するには、PLS (Persistent Local Storage)、コネクテッド ストレージ (例: XGameSaveXGameSaveFiles)、または同様のストレージ システムを使用してください。
XAppCaptureTakeScreenshot は、ユーザーがトリガーしたかのようにスクリーンショットを取得します。トーストが表示され、ゲームのスクリーンショットが保存されます。 ゲームが SDR で実行されている場合、1 つのファイルが生成されます。ゲームが HDR で実行されている場合、HDR 形式の 1 つと SDR 形式の 1 つ、計 2 つのファイルが生成されます。 スクリーンショットは、ユーザー設定に応じて XBOX Live に自動的にアップロードされる場合があります。スクリーンショットが正常に取得された後、XAppCaptureOpenScreenShotStream でスクリーンショット ストリームを開き、XAppCaptureReadScreenshotStream でスクリーンショットを読み取ることで、結果のファイルを読み取ることができます。これらの関数はどちらも、この関数から返された XAppCaptureTakeScreenshotResult で返されたローカル ID を使用する必要があります。

Requirements

ヘッダー: XAppCapture.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

Conceptual documentation

See also

GameDVR Overview
XAppCapture Members
XAppCaptureOpenScreenShotStream
XAppCaptureReadScreenShotStream
XAppCaptureCloseScreenshotStream
XAppCaptureTakeScreenshotResult
最終更新日 2026年8月24日