> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XtfCaptureScreenshot

> XtfCaptureScreenshot

# XtfCaptureScreenshot

指定した開発本体の現在の画面表示をビットマップとしてキャプチャします。

<a id="syntaxSection" />

## 構文

```cpp theme={null}
HRESULT XtfCaptureScreenshot(
         LPCWSTR address,
         HBITMAP* phBitmap
)  
```

<a id="parametersSection" />

### パラメーター

*address*   \
型: LPCWSTR

開発本体のツール IP アドレスまたはホスト名へのポインターです。

*phBitmap*   \
型: HBITMAP\*

成功した場合、キャプチャされた画面表示のビットマップの HBITMAP へのポインターです。 このビットマップの使用が終わったら、`DeleteObject` を呼び出して HBITMAP に関連付けられているリソースを解放します。

<a id="retvalSection" />

### 戻り値

型: HRESULT

成功した場合は `S_OK` を返します。それ以外の場合は HRESULT エラー コードを返します。

<a id="remarksSection" />

## 解説

この関数は、指定した開発本体の画面に現在表示されている内容のビットマップをキャプチャします。 ビットマップには、排他アプリ、共有アプリ、スナップされたアプリ、ホームや通知ポップアップなどのシステム UI など、本体出力に現在表示されているすべてのものが含まれます。 ビットマップは、本体で現在選択されている表示解像度を使用します。

**XtfCaptureScreenshot** を使用すると、ビデオ出力ストリームを一時的に制御します。 これにより、表示に一時的なフレームレートの乱れが発生し、キャプチャ時に GameDVR で録画されたビデオに黒画面のセグメントが発生する場合があります。

コードは推奨されるプログラミング手法に従い、`phBitmap` で返されるビットマップに埋め込まれた情報を使用して、結果のビットマップの解像度を判断する必要があります。 結果のビットマップの想定解像度は、開発本体の現在の画面解像度と一致します。

スクリーンショットのキャプチャの詳細については、[画面キャプチャ ツール (xbcapture.exe) (NDA トピック)](/tools/tools-console/commandlinetools/xbcapture) を参照してください。

<a id="requirementsSection" />

## 要件

**ヘッダー:** xtfconsolecontrol.h

**ライブラリ:** xtfconsolecontrol.lib

**サポートされているプラットフォーム:** Windows (XBOX 本体ツール用)

<a id="seealsoSection" />

## 関連項目

[XtfConsoleControl](/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members)\
[XBOX Tools Framework ネイティブ API リファレンス](/reference/tools/xtf/atoc-xtf-native)


## Related topics

- [XtfCaptureRecordedGameClip](/ja-jp/reference/tools/xtf/xtfapi/functions/xtfcapturegameclip-xbox-microsoft-m.md)
- [XAppCaptureTakeScreenshot](/ja-jp/reference/system/xappcapture/functions/xappcapturetakescreenshot.md)
- [XAppCaptureScreenshotFile](/ja-jp/reference/system/xappcapture/structs/xappcapturescreenshotfile.md)
- [XAppCaptureScreenshotStream](/ja-jp/reference/system/xappcapture/structs/xappcapturescreenshotstream.md)
- [XAppCaptureTakeDiagnosticScreenshot](/ja-jp/reference/system/xappcapture/functions/xappcapturetakediagnosticscreenshot.md)