Skip to main content

XAppCaptureOpenScreenshotStream

スクリーンショット ストリームを開きます。

構文

パラメーター

localId   _In_
型: char*
XAppCaptureTakeScreenshot を呼び出した後に XAppCaptureTakeScreenshotResult で返されるスクリーンショットのローカル ID です。 screenshotFormat   _In_
型: XAppCaptureScreenshotFormatFlag
XAppCaptureTakeScreenshot を呼び出した後に XAppCaptureTakeScreenshotResult で返されるスクリーンショット フォーマット フラグです。 handle   _Out_
型: XAppCaptureScreenshotStreamHandle*
ストリームを開いた結果として返されるスクリーンショット ストリーム ハンドルです。 totalBytes   _Out_opt_
型: uint64_t*
ストリーム内の合計バイト数です。

戻り値

型: HRESULT 関数の結果です。

解説

この関数は、時間依存スレッドで呼び出しても安全ではありません。 詳細については、「Time-sensitive threads」を参照してください。
スクリーンショットはゲーム パーティションからはアクセスできないため、ユーザーが撮影した、または XAppCaptureTakeScreenshot で撮影したスクリーンショットを取得するためには、ストリームを開く必要があります。 XAppCaptureTakeScreenshot は結果として localID を返し、これはこの関数で適切なスクリーンショットを取得するために使用されます。 localID は、スクリーンショットがディスクに保持されている限り有効です。 本体でスクリーンショットが保存される容量には限りがあります。 割り当てられた容量がいっぱいになると、古いスクリーンショットは削除されます。 これにより、open screenshot 関数が localID を見つけられない可能性があります。 ストリームを開いた後、XAppCaptureReadScreenShotStream でスクリーンショットを読み取ることができます。 最後に、メモリ リークを避けるため、すべてのストリームは XAppCaptureCloseScreenshotStream で閉じる必要があります。

要件

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

概念ドキュメント

関連項目

GameDVR の概要
XAppCapture メンバー
XAppCaptureReadScreenShotStream
XAppCaptureTakeScreenshot
XAppCaptureCloseScreenshotStream
最終更新日 2026年8月24日