Skip to main content

IXtfConsoleControlClient::GetConfigSettings

枚举所有配置设置,并针对每个配置设置调用回调。

语法

参数

pCallback
类型:IXtfConfigSettingsCallback*
指向 IXtfConfigSettingsCallback 接口实例的指针,将在枚举每个配置设置时被调用。

返回值

类型:HRESULT 如果成功,则返回 S_OK;否则返回 HRESULT 错误代码。

备注

此函数会导致 XBOX Tools Framework (XTF) API 枚举当前开发主机上的所有配置设置。找到配置设置时,XTF API 会调用你的应用中实现并在 pCallback 中指定的 IXtfConfigSettingsCallback 接口中的 OnFoundSetting 回调函数。当 XTF API 调用你实现的 OnFoundSetting 函数时,会传递一个指向描述配置设置的 XTFCONFIGSETTING 结构的指针。
XTFCONFIGSETTING 结构的内存归 XBOX Tools Framework (XTF) API 所有,并在每次调用你的 IXtfConfigSettingsCallback::OnFoundSetting 回调函数后失效。如果你稍后需要使用这些信息,则必须复制该结构中的信息。
你还可以使用 IXtfConsoleControlClient::GetAllSettings 方法返回当前开发主机上所有配置设置的 XTFCONFIGSETTING 结构数组。 有关使用 XBOX Tools Framework (XTF) 访问配置设置的详细信息,请参阅 配置 (xbconfig.exe) (NDA 主题)

要求

头文件: xtfconsolecontrol.h 库: xtfconsolecontrol.lib 支持的平台: Windows(适用于 XBOX 主机工具)

另请参阅

IXtfConfigSettingsCallback::OnFoundSetting
IXtfConsoleControlClient::GetAllSettings
IXtfConsoleControlClient
XtfConsoleControl
最后修改于 2026年8月24日