Pular para o conteúdo principal

IXtfConsoleControlClient::GetConfigSettings

Faz com que todas as definições de configuração sejam enumeradas, invocando um retorno de chamada para cada definição de configuração.

Sintaxe

Parâmetros

pCallback
Tipo: IXtfConfigSettingsCallback*
Um ponteiro para uma instância da interface IXtfConfigSettingsCallback, a ser invocada à medida que cada definição de configuração é enumerada.

Valor retornado

Tipo: HRESULT Retorna S_OK se for bem-sucedido; caso contrário, retorna um código de erro HRESULT.

Comentários

Essa função faz com que a API do XBOX Tools Framework (XTF) enumere todas as definições de configuração do console de desenvolvimento atual. Quando uma definição de configuração é encontrada, a API do XTF invoca a função de retorno de chamada OnFoundSetting da interface IXtfConfigSettingsCallback implementada no seu aplicativo e especificada em pCallback. A API do XTF passa um ponteiro para uma estrutura XTFCONFIGSETTING, que descreve a definição de configuração, quando invoca a função OnFoundSetting implementada por você.
A memória da estrutura XTFCONFIGSETTING pertence à API do XBOX Tools Framework (XTF) e é invalidada após cada invocação da sua função de retorno de chamada IXtfConfigSettingsCallback::OnFoundSetting. Você deve copiar as informações da estrutura se precisar delas para uso posterior.
Você também pode usar o método IXtfConsoleControlClient::GetAllSettings para retornar uma matriz de estruturas XTFCONFIGSETTING para todas as definições de configuração do console de desenvolvimento atual. Para obter mais informações sobre como acessar definições de configuração usando o XBOX Tools Framework (XTF), confira Configuração (xbconfig.exe) (tópico NDA).

Requisitos

Cabeçalho: xtfconsolecontrol.h Biblioteca: xtfconsolecontrol.lib Plataformas com suporte: Windows (para ferramentas de console XBOX)

Confira também

IXtfConfigSettingsCallback::OnFoundSetting
IXtfConsoleControlClient::GetAllSettings
IXtfConsoleControlClient
XtfConsoleControl
Última modificação em 20 de outubro de 2026