Skip to main content

XAppCaptureReadScreenshotStream

スクリーンショット ストリームを読み取ります。

構文

パラメーター

handle   _In_
型: XAppCaptureScreenshotStreamHandle
XAppCaptureOpenScreenshotStream を呼び出して返されたスクリーンショット ストリーム ハンドルです。 startPosition   _In_
型: uint64_t
読み取りを開始するストリーム内の位置です。 bytesToRead   _In_
型: uint32_t
ストリームで読み取るバイト数です。 buffer   _Out_writes_to_(bytesToRead,bytesWritten)
型: uint8_t
XAppCaptureReadScreenshotStream で読み取ったバイトを格納するバッファーです。 bytesWritten   _Out_
型: uint32_t*
buffer に実際に書き込まれたバイト数です。

戻り値

型: HRESULT 関数の結果です。

解説

この関数は、時間依存スレッドで呼び出しても安全ではありません。 詳細については、「Time-sensitive threads」を参照してください。
スクリーンショットを読み取る前に、XAppCaptureOpenScreenShotStream でスクリーンショット ストリームを開く必要があります。 これにより、handle パラメーターに必要な XAppCaptureScreenshotStreamHandle が生成されます。 その後、この関数を呼び出してスクリーンショットを読み取ることができます。 startPosition パラメーターと bytesToRead パラメーターにより、スクリーンショットの一部分を読み取ることができます。これは、大きなストリームを一度に一部分ずつ読み取るのに便利です。 ストリームの合計サイズは、XAppCaptureOpenScreenShotStreamtotalBytes 出力パラメーターから取得できます。 出力パラメーター bufferbytesWritten は、この関数から返されるデータを正確に読み取るのに役立ちます。 スクリーンショット データを読み取った後、メモリ リークを避けるため、XAppCaptureCloseScreenshotStream でスクリーンショット ストリームを閉じます。

要件

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

概念ドキュメント

関連項目

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