> ## 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.

# XtfCreateConsoleManager

> XtfCreateConsoleManager

# XtfCreateConsoleManager

初始化 [IXtfConsoleManager](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) 接口的新实例。

## 语法

```cpp theme={null}
HRESULT XtfCreateConsoleManager(
         IXtfConsoleManagerCallback *pCallback,
         REFIID riid,
         void **ppvObject
)  
```

### 参数

*pCallback*\
类型：IXtfConsoleManagerCallback\*

指向 [IXtfConsoleManagerCallback](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft-t.md) 回调的指针，当添加、移除或更改 [IXtfConsoleManager](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) 实例中的开发主机时调用此回调。

*riid*\
类型：REFIID

接收新创建的 [IXtfConsoleManager](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) 实例的实例标识符的指针。

*ppvObject*\
类型：void\*\*

接收对新创建的 [IXtfConsoleManager](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) 实例的引用的指针。

### 返回值

类型：HRESULT

如果成功，则返回 `S_OK`；否则返回 HRESULT 错误代码。

## 备注

此函数初始化 [IXtfConsoleManager](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) 接口的实例。该接口处理 XBOX Tools Framework (XTF) API 的常见主机管理函数。这些函数包括添加、枚举和移除开发主机；获取和设置默认开发主机；以及检索有关开发主机的信息。

有关连接和查询开发主机的详细信息，请参阅 [Connect (xbconnect.exe) (NDA 主题)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xbconnect.md)。

## 要求

**头文件：** xtfconsolemanager.h

**库：** xtfconsolemanager.lib

**支持的平台：** Windows（适用于 XBOX 主机工具）

## 另请参阅

[XtfGetDefaultAddress](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/methods/xtfgetdefaultaddress-xtfconsolemanager-xbox-windows-m.md)\
[IXtfConsoleManager Interface](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md)\
[XtfConsoleManager](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/xtfconsolemanager-xbox-microsoft-n.md)


## Related topics

- [XtfConsoleManager（API 内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/xtfconsolemanager-xbox-microsoft-n.md)
- [XtfCreateConsoleControlClient](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolecontrol/functions/xtfcreateconsolecontrolclient-xtfconsolecontrol-xbox-microsoft-m.md)
- [IXtfConsoleManager 接口（接口内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md)
- [AddConsole](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/addconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [EnumerateConsoles](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/enumerateconsoles-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)