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

# IXtfConsoleControlClient::GetConfigSettings

> IXtfConsoleControlClient::GetConfigSettings

# IXtfConsoleControlClient::GetConfigSettings

列舉所有組態設定，並針對每個組態設定叫用回呼。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
HRESULT GetConfigSettings(
         IXtfConfigSettingsCallback *pCallback
)  
```

<a id="parametersSection" />

### 參數

*pCallback*\
類型：[IXtfConfigSettingsCallback](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback)\*

指向 [IXtfConfigSettingsCallback](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback) 介面執行個體的指標，會在列舉每個組態設定時叫用。

<a id="retvalSection" />

### 傳回值

類型：HRESULT

如果成功，則傳回 `S_OK`；否則傳回 HRESULT 錯誤碼。

<a id="remarksSection" />

## 備註

此函式會使 XBOX Tools Framework (XTF) API 列舉目前開發主機上的所有組態設定。找到組態設定時，XTF API 會叫用您應用程式中實作並於 `pCallback` 中指定之 [IXtfConfigSettingsCallback](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback) 介面的 [OnFoundSetting](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting) 回呼函式。XTF API 在叫用您實作的 `OnFoundSetting` 函式時，會傳遞指向描述該組態設定之 [XTFCONFIGSETTING](/zh-TW/reference/tools/xtf/xtfconsolecontrol/structs/xtfconfigsetting) 結構的指標。

<Note>[XTFCONFIGSETTING](/zh-TW/reference/tools/xtf/xtfconsolecontrol/structs/xtfconfigsetting) 結構的記憶體由 XBOX Tools Framework (XTF) API 所擁有，且會在每次叫用您的 [IXtfConfigSettingsCallback::OnFoundSetting](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting) 回呼函式之後失效。如果您之後需要使用結構中的資訊，必須加以複製。</Note>

您也可以使用 [IXtfConsoleControlClient::GetAllSettings](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings) 方法，傳回目前開發主機上所有組態設定的 `XTFCONFIGSETTING` 結構陣列。

如需使用 XBOX Tools Framework (XTF) 存取組態設定的詳細資訊，請參閱[組態 (xbconfig.exe) (NDA 主題)](/zh-TW/tools/tools-console/commandlinetools/xbconfig)。

<a id="requirementsSection" />

## 需求

**標頭：** xtfconsolecontrol.h

**程式庫：** xtfconsolecontrol.lib

**支援的平台：** Windows (適用於 XBOX 主機工具)

<a id="seealsoSection" />

## 另請參閱

[IXtfConfigSettingsCallback::OnFoundSetting](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting)\
[IXtfConsoleControlClient::GetAllSettings](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings)\
[IXtfConsoleControlClient](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient)\
[XtfConsoleControl](/zh-TW/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members)


## Related topics

- [IXtfConsoleControlClient::GetAllSettings](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings.md)
- [IXtfConsoleControlClient::GetConfigValue](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getconfigvalue.md)
- [IXtfConfigSettingsCallback::OnFoundSetting](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting.md)
- [XTFCONFIGSETTING](/zh-TW/reference/tools/xtf/xtfconsolecontrol/structs/xtfconfigsetting.md)
- [IXtfConsoleControlClient](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)