Skip to main content

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 本体ツール用)

関連項目

XtfConsoleControl
XBOX Tools Framework ネイティブ API リファレンス
最終更新日 2026年8月24日