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

# XtfCreateConsoleControlClient

> XtfCreateConsoleControlClient

# XtfCreateConsoleControlClient

指定したアドレスで [IXtfConsoleControlClient](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md) インターフェイスの新しいインスタンスを初期化します。

## 構文

```cpp theme={null}
HRESULT XtfCreateConsoleControlClient(
         LPCWSTR pszAddress,
         REFIID riid,
         void **ppvObject
)  
```

### パラメーター

*pszAddress*\
型: LPCWSTR

新しい [IXtfConsoleControlClient](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md) インスタンスに使用する開発本体のツール IP アドレスへのポインターです。

*riid*\
型: REFIID

新しく作成された [IXtfConsoleControlClient](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md) インスタンスのインスタンス識別子を受け取るポインターです。

*ppvObject*\
型: void\*\*

新しく作成された [IXtfConsoleControlClient](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md) インスタンスへの参照を受け取るポインターです。

### 戻り値

型: HRESULT

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

## 解説

この関数は、`pszAddress` で指定された本体に [IXtfConsoleControlClient](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md) の新しいインスタンスを作成してアタッチします。 その後、新しい `IXtfConsoleControlClient` インスタンスを使用して、構成設定、システム時刻、現在実行中のプロセスなどの情報を本体から取得できます。 構成値の設定、スタック ダンプの生成、本体のシャットダウンも行えます。

XBOX Tools Framework (XTF) など、利用可能なツールおよび自動化 API の詳細については、[ツールおよび自動化 API (NDA トピック)](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/debug/atoc-api-tools-dev-env) を参照してください。

## 要件

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

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

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

## 関連項目

[XtfConsoleControl](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)\
[XBOX Tools Framework](https://docs.xbox.com/ja-jp/reference/tools/xtf/atoc-xbox-tools-framework.md)


## Related topics

- [XtfConsoleControl (API の内容)](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)
- [IXtfConsoleControlClient (インターフェイスの内容)](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
- [ShutdownConsole](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_shutdownconsole.md)
- [SetConfigValue](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_setconfigvalue.md)
- [GetAllSettings](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings.md)